Skip to content

Rotate a pending invitation's secret and mail the new link to the invitee (409 invite_delivery_unavailable without a mailer)

POST
/v1/invites/{id}/resend
curl --request POST \
--url https://example.com/v1/invites/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/resend \
--header 'Authorization: Bearer <token>'

Rotates a pending invitation’s secret and mails the new link to the invitee (202); the token travels only in the mail. 409 when no mailer is configured.

id
required
string format: uuid

Resource identifier (UUIDv7).

X-Olivares-Tenant
string format: uuid

Target tenant id; required when the principal can act in more than one tenant.

Accepted

Media type application/json
object
delivery
required

Whether the invitation email left the engine; the token travels only in the mail.

string
Allowed values: sent failed
expires_at
required
string format: date-time
id
required
string format: uuid
Example
{
"delivery": "sent"
}

Bad request

Media type application/json
object
error
required
object
code
required
string
message
required
string
module

With code module_not_enabled: the namespace of the module this node does not run.

string
Example generated
{
"error": {
"code": "example",
"message": "example",
"module": "example"
}
}

Unauthenticated

Media type application/json
object
error
required
object
code
required
string
message
required
string
module

With code module_not_enabled: the namespace of the module this node does not run.

string
Example generated
{
"error": {
"code": "example",
"message": "example",
"module": "example"
}
}

Forbidden

Media type application/json
object
error
required
object
code
required
string
message
required
string
module

With code module_not_enabled: the namespace of the module this node does not run.

string
Example generated
{
"error": {
"code": "example",
"message": "example",
"module": "example"
}
}

Not found

Media type application/json
object
error
required
object
code
required
string
message
required
string
module

With code module_not_enabled: the namespace of the module this node does not run.

string
Example generated
{
"error": {
"code": "example",
"message": "example",
"module": "example"
}
}

Conflict / setup required

Media type application/json
object
error
required
object
code
required
string
message
required
string
module

With code module_not_enabled: the namespace of the module this node does not run.

string
Example generated
{
"error": {
"code": "example",
"message": "example",
"module": "example"
}
}

Rate limited

Media type application/json
object
error
required
object
code
required
string
message
required
string
module

With code module_not_enabled: the namespace of the module this node does not run.

string
Example generated
{
"error": {
"code": "example",
"message": "example",
"module": "example"
}
}