Skip to main content
POST
/
connections
/
{nameOrID}
/
credentials
Create Connection Credentials
curl --request POST \
  --url https://use.hoop.dev/api/connections/{nameOrID}/credentials \
  --header 'Content-Type: application/json' \
  --data '
{
  "access_duration_seconds": 123
}
'
{
  "connection_credentials": "<unknown>",
  "connection_name": "pgdemo",
  "connection_type": "postgres",
  "created_at": "2025-08-25T12:00:00Z",
  "expire_at": "2025-08-25T13:00:00Z",
  "id": "15B5A2FD-0706-4A47-B1CF-B93CCFC5B3D7"
}

Documentation Index

Fetch the complete documentation index at: https://hoopdev-docs-concepts-gaps-and-organization.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Path Parameters

​
nameOrID
string
required

Name or UUID of the connection

Body

application/json

The request body resource

​
access_duration_seconds
integer

Response

Created

​
connection_credentials
any

The connection information

​
connection_name
string

The name of the connection

Example:

"pgdemo"

​
connection_type
string

Connection type

Example:

"postgres"

​
created_at
string

When the resource was created

Example:

"2025-08-25T12:00:00Z"

​
expire_at
string

When the database access connection expires

Example:

"2025-08-25T13:00:00Z"

​
id
string<uuid>
read-only

The unique identifier of the connection database access

Example:

"15B5A2FD-0706-4A47-B1CF-B93CCFC5B3D7"