Skip to content

The company’s SCIM tokens

GET
/v1/companies/{id}/scim/tokens
curl --request GET \
--url https://beta-api.plune.ai/v1/companies/example/scim/tokens \
--cookie plune_session=<plune_session>

Live and ended, oldest first; never a value. The company owner only, with the session. A company without Enterprise in active or grace is refused 403 enterprise_required; it loses nothing and nobody is switched off.

id
required
string

The tokens

Media type application/json
object
tokens
required
Array<object>

A SCIM token of the company: never the value, never its hash.

object
id
required
string
prefix
required

The non-secret start of the value.

string
createdBy
required
string
createdAt
required
string format: date-time
expiresAt
required
string format: date-time
revokedAt
required
string format: date-time
nullable
lastUsedAt
required

The last request the directory made with it; null before the first. Written at most once a minute, so it can be up to a minute behind.

string format: date-time
nullable
scim
required

What the directory has done in the company.

object
provisionedCount
required

People the directory has in the company right now: its switched-on links whose person is still a member of the company and not in the Bin. Someone removed by hand or deleted is not counted; someone who was a member before the directory linked them is.

integer
Example
{
"tokens": [
{
"prefix": "plune_scim_Ab12Cd"
}
]
}

No session

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

Not the owner, or no Enterprise (code: enterprise_required)

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

A company the caller is not in

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