A request to join, for an administrator

GET

/orgs/{org}/access-requests/{id}

curl --request GET \
  --url https://api.sloose.com/orgs/org_9f3c/access-requests/ar_3k9d \
  --header 'Authorization: Bearer <token>'

• Production
• Staging

Who asked, their address, the CRM their Zoho sign-in proved and whether it is still open. The page the administrators’ mail links to reads this; approving is POST …/approve, never a link, since mail scanners follow links.

Administrators, and a session only.

Authorizations

• sessionAuth

Parameters

Path Parameters

org

required

The org id the session was issued for. A token for one org can never read another.

string

Example

org_9f3c

The org id the session was issued for. A token for one org can never read another.

id

required

The request, from the link in the administrators’ mail.

string

Example

ar_3k9d

The request, from the link in the administrators’ mail.

Responses

200

The request.

Media typeapplication/json

object

request

required

object

id

required

string

orgName

required

string

requesterName

required

The name they signed in with. Null when they gave none, or gave one that could be read as Sloose — it is not shown, here or in the mail, since it is theirs to choose.

string | null

requesterEmail

required

string

crmName

required

The CRM the person’s Zoho sign-in proved, as it names itself — null, by the same rule, when that name could be read as Sloose.

string | null

status

required

string

Allowed values: open approved expired

requestedAt

required

string

expiresAt

required

string

decidedAt

required

string | null

Example

{
  "request": {
    "status": "open"
  }
}

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

Not an owner or administrator of this org, a bearer issued for another org, or an API token (code: SESSION_REQUIRED).

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 request in this org (code: ACCESS_REQUEST_NOT_FOUND).

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"
}