Skip to content
Management API Reference

Invites an external user to a database for JIT access

post/v1/projects/{ref}/database/jit/invite

Invites the external user and sets initial roles that can be assumed and for how long

The fine-grained token must include the following permissions to access this endpoint:

  • database_jit_write

Path parameters

  • ref
    Required
    string

    Project ref

Body

  • email
    Required
    string
  • roles
    Required
    Array<object>

Response codes

  • 200
  • 401
  • 403
  • 429
  • 500

Response (200)

1
{
2
  "email": "hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhg@effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.effffffffffffffffffffffffffffffffffffffffffffffffff.ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ",
3
  "invite_id": "00000000-0000-0000-0000-000000000000",
4
  "user_roles": [
5
    {
6
      "role": "lorem",
7
      "expires_at": 42,
8
      "allowed_networks": {
9
        "allowed_cidrs": [
10
          {
11
            "cidr": "144.144.144.144/14"
12
          }
13
        ],
14
        "allowed_cidrs_v6": [
15
          {
16
            "cidr": "::/104"
17
          }
18
        ]
19
      },
20
      "branches_only": true
21
    }
22
  ]
23
}