Skip to main content
POST
/
link-requests
Create a link request
curl --request POST \
  --url https://api.northca.dev/v1/link-requests \
  --header 'Content-Type: application/json' \
  --header 'x-discord-guild: <x-discord-guild>' \
  --header 'x-partner-key: <api-key>' \
  --data '
{
  "mdt_id": "0c7f6a0c-2c4f-4f44-b16a-2b6b8d8fe2c2"
}
'
{
  "ok": true,
  "data": {
    "id": "<string>",
    "partner": "<string>",
    "mdt_id": "<string>",
    "guild_id": "<string>",
    "status": "pending",
    "requester_discord_id": "<string>",
    "owner_discord_id": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "expires_at": "2023-11-07T05:31:56Z",
    "decided_at": "2023-11-07T05:31:56Z"
  }
}

Authorizations

​
x-partner-key
string
header
required

Partner API key provided by Northca.

Headers

​
x-discord-guild
string
required

Discord Guild ID (server/guild context for the request).

​
x-discord-actor
string

Discord User ID for the acting user (optional; used for audit fields).

Body

application/json
​
mdt_id
string
required

MDT ID you want to link.

Response

Link request created.

​
ok
boolean
required
​
data
object
required

Link request created for an MDT.