Testkube Control Plane ../invites organisation operations
Testkube Pro API (cloud-api/1.10.51)
Download OpenAPI specification:Download
API for Testkube Pro
List organization invites
Lists all invites for an organization.
Authorizations:
path Parameters
| id required  | string  unique id of the object  | 
query Parameters
| status | string  Enum: "pending" "revoked" "accepted" "declined" "failed"   The status of the invites.  | 
Responses
Response samples
- 200
 - 401
 - 403
 
[- {
- "id": "string",
 - "organization": "string",
 - "status": "pending",
 - "email": "string",
 - "inviter": "string",
 - "token": "string",
 - "role": "string",
 - "envRole": "string",
 - "envs": [
- "string"
 
], - "teams": [
- "string"
 
], - "createdAt": "2019-08-24T14:15:22Z",
 - "updatedAt": "2019-08-24T14:15:22Z",
 - "expiresAt": "2019-08-24T14:15:22Z",
 - "revokedAt": "2019-08-24T14:15:22Z",
 - "acceptedAt": "2019-08-24T14:15:22Z",
 - "declinedAt": "2019-08-24T14:15:22Z"
 
} 
]Invite users to the organization
Invites one or more users to this organization.
Authorizations:
path Parameters
| id required  | string  unique id of the object  | 
Request Body schema: application/jsonrequired
| emails required  | Array of strings  Email of the invitee.  | 
| role | string  The role that will be assigned to the person after accepting.  | 
| teams | Array of strings  Teams which the person will get access to after accepting the invite.  | 
| envs | Array of strings  Environments which the person will get access to after accepting the invite.  | 
| envRole | string  The role that will be assigned to the person's environments after accepting.  | 
Responses
Request samples
- Payload
 
{- "emails": [
- "string"
 
], - "role": "string",
 - "teams": [
- "string"
 
], - "envs": [
- "string"
 
], - "envRole": "string"
 
}Response samples
- 200
 - 400
 - 401
 - 403
 
{- "invites": [
- {
- "id": "string",
 - "organization": "string",
 - "status": "pending",
 - "email": "string",
 - "inviter": "string",
 - "token": "string",
 - "role": "string",
 - "envRole": "string",
 - "envs": [
- "string"
 
], - "teams": [
- "string"
 
], - "createdAt": "2019-08-24T14:15:22Z",
 - "updatedAt": "2019-08-24T14:15:22Z",
 - "expiresAt": "2019-08-24T14:15:22Z",
 - "revokedAt": "2019-08-24T14:15:22Z",
 - "acceptedAt": "2019-08-24T14:15:22Z",
 - "declinedAt": "2019-08-24T14:15:22Z"
 
} 
], - "failed": [
- "string"
 
] 
}Get organization invite
Get an invite for an organization with given id.
Authorizations:
path Parameters
| id required  | string  unique id of the object  | 
| inviteID required  | string  unique invite ID  | 
Responses
Response samples
- 200
 - 401
 - 403
 - 404
 
{- "id": "string",
 - "organization": "string",
 - "status": "pending",
 - "email": "string",
 - "inviter": "string",
 - "token": "string",
 - "role": "string",
 - "envRole": "string",
 - "envs": [
- "string"
 
], - "teams": [
- "string"
 
], - "createdAt": "2019-08-24T14:15:22Z",
 - "updatedAt": "2019-08-24T14:15:22Z",
 - "expiresAt": "2019-08-24T14:15:22Z",
 - "revokedAt": "2019-08-24T14:15:22Z",
 - "acceptedAt": "2019-08-24T14:15:22Z",
 - "declinedAt": "2019-08-24T14:15:22Z"
 
}Updates an organization invite
Updates an organization invite.
Authorizations:
path Parameters
| id required  | string  unique id of the object  | 
| inviteID required  | string  unique invite ID  | 
Request Body schema: application/jsonrequired
| role | string  The role that will be assigned to the person after accepting.  | 
| teams | Array of strings  Teams which the person will get access to after accepting the invite.  | 
| envs | Array of strings  Environments which the person will get access to after accepting the invite.  | 
| envRole | string  The role that will be assigned to the person's environments after accepting.  | 
Responses
Request samples
- Payload
 
{- "role": "string",
 - "teams": [
- "string"
 
], - "envs": [
- "string"
 
], - "envRole": "string"
 
}Response samples
- 200
 - 400
 - 401
 - 403
 - 404
 
{- "id": "string",
 - "organization": "string",
 - "status": "pending",
 - "email": "string",
 - "inviter": "string",
 - "token": "string",
 - "role": "string",
 - "envRole": "string",
 - "envs": [
- "string"
 
], - "teams": [
- "string"
 
], - "createdAt": "2019-08-24T14:15:22Z",
 - "updatedAt": "2019-08-24T14:15:22Z",
 - "expiresAt": "2019-08-24T14:15:22Z",
 - "revokedAt": "2019-08-24T14:15:22Z",
 - "acceptedAt": "2019-08-24T14:15:22Z",
 - "declinedAt": "2019-08-24T14:15:22Z"
 
}Resend organization invite
Resend an invite for an organization with given id.
Authorizations:
path Parameters
| id required  | string  unique id of the object  | 
| inviteID required  | string  unique invite ID  | 
Responses
Response samples
- 401
 - 403
 - 404
 
{- "title": "Invalid test name",
 - "status": 500,
 - "detail": "Your test name can't contain forbidden characters like \"}}}\" passed",
 
}Revoke organization invite
Revoke an invite for an organization with given id.
Authorizations:
path Parameters
| id required  | string  unique id of the object  | 
| inviteID required  | string  unique invite ID  | 
Responses
Response samples
- 400
 - 401
 - 403
 - 404
 
{- "title": "Invalid test name",
 - "status": 500,
 - "detail": "Your test name can't contain forbidden characters like \"}}}\" passed",
 
}