Open App

Stacks

API endpoints for stacks

List stack directory entries

GET /api/v1/stacks

Parameters

NameInTypeRequiredDescription
organisationIdquerystringNo
searchquerystringNo
categoryIdquerystringNo
subcategoryIdquerystringNo
limitqueryintegerNo

Example request

curl -X GET \
"https://api.example.com/api/v1/stacks?organisationId=<organisationId>&search=<search>&categoryId=<categoryId>&subcategoryId=<subcategoryId>&limit=<limit>" \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json"

Example response

Status: 200

{
  "data": [
    {
      "_id": "string",
      "name": "string",
      "website": "string",
      "docs": "string",
      "description": "string",
      "userId": "string",
      "organisationId": "string",
      "createdAt": 0,
      "updatedAt": 0
    }
  ]
}

Response body type

{ data: Stack[] }


Create stack directory entry

POST /api/v1/stacks

Example request

curl -X POST \
"https://api.example.com/api/v1/stacks" \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json"
-d '{"name":"string","website":"string","docs":"string","description":"string","organisationId":"string","categoryIds":["string"],"subcategoryIds":["string"],"containerIds":["string"]}'

Response body type


Get stack directory entry

GET /api/v1/stacks/{id}

Parameters

NameInTypeRequiredDescription
idpathstringYesPath parameter.

Example request

curl -X GET \
"https://api.example.com/api/v1/stacks/<id>" \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json"

Example response

Status: 200

{
  "data": {
    "_id": "string",
    "name": "string",
    "website": "string",
    "docs": "string",
    "description": "string",
    "userId": "string",
    "organisationId": "string",
    "createdAt": 0,
    "updatedAt": 0
  }
}

Response body type

{ data: Stack }


Update stack directory entry

PATCH /api/v1/stacks/{id}

Parameters

NameInTypeRequiredDescription
idpathstringYesPath parameter.

Example request

curl -X PATCH \
"https://api.example.com/api/v1/stacks/<id>" \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json"
-d '{"name":"string","website":"string","docs":"string","description":"string","containerIds":["string"]}'

Response body type


Delete stack directory entry

DELETE /api/v1/stacks/{id}

Parameters

NameInTypeRequiredDescription
idpathstringYesPath parameter.

Example request

curl -X DELETE \
"https://api.example.com/api/v1/stacks/<id>" \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json"

Response body type