Accept an invitation

POST

/invitations/{token}/accept

curl --request POST \
  --url https://api.sloose.com/invitations/k3f%E2%80%A6/accept \
  --header 'Authorization: Bearer <token>'

• Production
• Staging

Joins the org at the invited role, as the signed-in person — whose email must be the invited address. The session moves to that org. Somebody already in the org is unblocked and takes the invited role.

Authorizations

• sessionAuth

Parameters

Path Parameters

token

required

The token from the invitation link.

string

Example

k3f…

The token from the invitation link.

Responses

200

Joined.

Media typeapplication/json

object

orgId

required

string

orgName

required

string

role

required

string

Allowed values: owner admin builder operator

Example

{
  "role": "owner"
}

401

No bearer, or one that is expired, revoked or no longer resolves to a member.

Media typeapplication/json

The error envelope every non-2xx answer uses.

object

error

required

Human-readable explanation.

string

code

Machine-readable reason. Absent on a few legacy 400s.

string

key

additional properties

Example^generated

{
  "error": "example",
  "code": "example"
}

403

The signed-in address is not the one invited (code: WRONG_EMAIL), or an API token was used.

Media typeapplication/json

The error envelope every non-2xx answer uses.

object

error

required

Human-readable explanation.

string

code

Machine-readable reason. Absent on a few legacy 400s.

string

key

additional properties

Example^generated

{
  "error": "example",
  "code": "example"
}

404

No such invitation, or it is not visible to this session.

Media typeapplication/json

The error envelope every non-2xx answer uses.

object

error

required

Human-readable explanation.

string

code

Machine-readable reason. Absent on a few legacy 400s.

string

key

additional properties

Example^generated

{
  "error": "example",
  "code": "example"
}

409

The invitation is withdrawn, used or expired.

Media typeapplication/json

The error envelope every non-2xx answer uses.

object

error

required

Human-readable explanation.

string

code

Machine-readable reason. Absent on a few legacy 400s.

string

key

additional properties

Example^generated

{
  "error": "example",
  "code": "example"
}