Skip to content

Mark an account or a company as a service or test one, or clear the mark

PUT
/v1/admin/service-flag
curl --request PUT \
--url https://beta-api.plune.ai/v1/admin/service-flag \
--header 'Content-Type: application/json' \
--cookie plune_session=<plune_session> \
--data '{ "subject": { "kind": "company", "id": "6f1c2b3a-0000-4000-8000-0000000000a5" }, "service": true }'

#2980 (operator decision 2А, 21.11.2026): service: true leaves the account or the company out of every step of the activation funnel (ops.activation_funnel); false brings it back. Every account and company starts unmarked. The admin journal records the call with its subject and the mark. Owner-only, as POST /v1/admin/tier-grants (an admin token with the tier-grants door too; one without it is refused 403); everyone else gets 404, before the body is read. Ten calls a minute.

Media type application/json
object
subject
required
object
kind
required
string
Allowed values: user company
id
required
string
>= 1 characters <= 100 characters
service
required
boolean
Examples

A test company of the team, out of the funnel

{
"subject": {
"kind": "company",
"id": "6f1c2b3a-0000-4000-8000-0000000000a5"
},
"service": true
}

The mark as it is now

Media type application/json
object
subject
required
object
kind
required
string
Allowed values: user company
id
required
string
service
required
boolean
Example
{
"subject": {
"kind": "company",
"id": "6f1c2b3a-0000-4000-8000-0000000000a5"
},
"service": true
}

Not JSON, or a field that does not hold — a kind other than user or company, a mark that is not true or false

Media type application/json
object
error
required
string
Example
{
"error": "validation failed — service: must be true or false"
}

No / invalid session

An admin token that was not given the tier-grants door

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}

The caller does not own the application — or there is no such account or company (a company in the Bin included)

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}

Rate-limited: the per-route throttle, or the per-minute request limit of the plan an API token counts by (#1442; the body names the plan, #2092). Retry-After carries the seconds until the window rolls over.

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}
Retry-After
integer

Seconds until the window rolls over