Create organization invitations
Creates or refreshes organization invitations. Currently unavailable in self-hosted ECE.
Path parameters
-
Identifier for the Organization
Body Required
The organization invitations to create or refresh
-
The email addresses to invite to the organization
-
expires_in string
The date and time when the invitation expires. Defaults to three days from now.
-
role_assignments object
The roles that will be assigned to users once they accept the invitation. Currently unavailable in self-hosted ECE.
Additional properties are allowed.
Responses
-
Organization invitations created successfully
-
- Invitation email was not valid. (code:
organization.invitation_invalid_email
) - Invitation already sent. (code:
organization.invitation_already_exists
) - User already belongs to organization. (code:
organization.user_organization_already_belongs
)
- Invitation email was not valid. (code:
-
The current user authentication is not valid. (code:
root.invalid_authentication
) -
- Organization not found. (code:
organization.not_found
) - User not found. (code:
user.not_found
) - Invitation sender does not belong to organization. (code:
organization.user_organization_does_not_belong
)
- Organization not found. (code:
-
Request exceeds organization invitation creation rate limits. (code:
organization.invitations_rate_limit_exceeded
)
POST /organizations/{organization_id}/invitations
curl \
-X POST https://api.elastic-cloud.com/api/v1/organizations/{organization_id}/invitations \
-d '{"emails":["string"],"expires_in":"string","role_assignments":{"platform":[{"role_id":"string"}],"organization":[{"role_id":"string","organization_id":"string"}],"deployment":[{"role_id":"string","organization_id":"string","all":true,"deployment_ids":["string"],"application_roles":["string"]}],"project":{"elasticsearch":[{"role_id":"string","organization_id":"string","all":true,"project_ids":["string"],"application_roles":["string"]}],"observability":[{"role_id":"string","organization_id":"string","all":true,"project_ids":["string"],"application_roles":["string"]}],"security":[{"role_id":"string","organization_id":"string","all":true,"project_ids":["string"],"application_roles":["string"]}]}}}'
Request examples
{
"emails": [
"string"
],
"expires_in": "string",
"role_assignments": {
"platform": [
{
"role_id": "string"
}
],
"organization": [
{
"role_id": "string",
"organization_id": "string"
}
],
"deployment": [
{
"role_id": "string",
"organization_id": "string",
"all": true,
"deployment_ids": [
"string"
],
"application_roles": [
"string"
]
}
],
"project": {
"elasticsearch": [
{
"role_id": "string",
"organization_id": "string",
"all": true,
"project_ids": [
"string"
],
"application_roles": [
"string"
]
}
],
"observability": [
{
"role_id": "string",
"organization_id": "string",
"all": true,
"project_ids": [
"string"
],
"application_roles": [
"string"
]
}
],
"security": [
{
"role_id": "string",
"organization_id": "string",
"all": true,
"project_ids": [
"string"
],
"application_roles": [
"string"
]
}
]
}
}
}
Response examples (201)
{
"invitations": [
{
"token": "string",
"email": "string",
"created_at": "2024-05-04T09:42:00+00:00",
"expires_at": "2024-05-04T09:42:00+00:00",
"expired": true,
"accepted_at": "2024-05-04T09:42:00+00:00",
"organization": {
"id": "string",
"name": "string",
"default_disk_usage_alerts_enabled": true,
"notifications_allowed_email_domains": [
"string"
],
"billing_contacts": [
"string"
],
"operational_contacts": [
"string"
],
"sso_login_identifier": "string"
},
"role_assignments": {
"platform": [
{
"role_id": "string"
}
],
"organization": [
{
"role_id": "string",
"organization_id": "string"
}
],
"deployment": [
{
"role_id": "string",
"organization_id": "string",
"all": true,
"deployment_ids": [
"string"
],
"application_roles": [
"string"
]
}
],
"project": {
"elasticsearch": [
{
"role_id": "string",
"organization_id": "string",
"all": true,
"project_ids": [
"string"
],
"application_roles": [
"string"
]
}
],
"observability": [
{
"role_id": "string",
"organization_id": "string",
"all": true,
"project_ids": [
"string"
],
"application_roles": [
"string"
]
}
],
"security": [
{
"role_id": "string",
"organization_id": "string",
"all": true,
"project_ids": [
"string"
],
"application_roles": [
"string"
]
}
]
}
}
}
]
}
Response examples (400)
# Headers
x-cloud-error-codes: organization.invitation_invalid_email
# Payload
{
"errors": [
{
"code": "string",
"message": "string",
"fields": [
"string"
]
}
]
}
Response examples (403)
# Headers
x-cloud-error-codes: root.invalid_authentication
# Payload
{
"errors": [
{
"code": "string",
"message": "string",
"fields": [
"string"
]
}
]
}
Response examples (404)
# Headers
x-cloud-error-codes: organization.not_found
# Payload
{
"errors": [
{
"code": "string",
"message": "string",
"fields": [
"string"
]
}
]
}
Response examples (429)
# Headers
x-cloud-error-codes: organization.invitations_rate_limit_exceeded
# Payload
{
"errors": [
{
"code": "string",
"message": "string",
"fields": [
"string"
]
}
]
}