Your requests to join

GET

/auth/access-requests

curl --request GET \
  --url 'https://api.sloose.com/auth/access-requests?zohoOrgId=7000000001' \
  --header 'Authorization: Bearer <token>'

• Production
• Staging

What the person asked of the orgs holding this CRM, newest first — open, or approved while the invitation waits — and whether they have joined since. A request is to an org, so one made from another CRM that org also holds is here too, once this session’s Zoho sign-in has proved THIS CRM (the frame route’s test); before that, only the requests made from this CRM. A CRM tab polls this while somebody waits in it, and asks the frame route again once joined is true.

Without zohoOrgId, every request the person made, from any CRM — the page for a person in no org lists them (#674). Each names an org the person was told of when they asked.

Session only, and limited (429 RATE_LIMITED).

Authorizations

• sessionAuth

Parameters

Query Parameters

zohoOrgId

The CRM the tab is in: its zgid. Left out, every request the person made, from any CRM.

string

>= 1 characters

Example

7000000001

The CRM the tab is in: its zgid. Left out, every request the person made, from any CRM.

Responses

200

Your requests.

Media typeapplication/json

object

requests

required

Array<object>

object

id

required

string

orgId

required

string

orgName

required

The org asked, as somebody outside it is shown its name: “a team” when the name could be read as Sloose, as an invitation does.

string

status

required

open until an administrator approves it, or it lapses (7 days); approved once the invitation is on its way.

string

Allowed values: open approved

requestedAt

required

string

expiresAt

required

string

joined

required

Whether the person is a member of the org now — the invitation accepted — which is what a tab waiting on the request is waiting for.

boolean

Example

{
  "requests": [
    {
      "status": "open"
    }
  ]
}

400

The request — its body or its query — did not match the schema. issues carries the Zod issue list.

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

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

An API token was used (code: SESSION_REQUIRED), or a staff member’s view of an org asked with no zohoOrgId (code: STAFF_VIEW): every request the person made is theirs, not the org’s the view was opened on.

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

429

Too many requests (code: RATE_LIMITED, with retryAfterSeconds).

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