List resources

List Forward-registered resources of one type.

GET /api/v1/forward/resources

Returns resources owned by the current caller. Results include live resource_spec data when the resource remains visible.

Headers

Header	Required	Description
Authorization	Yes	Bearer <PAT>

Query parameters

Parameter	Type	Required	Default	Description
type	string	Yes	-	Resource type: skill, file, vault, or environment.
limit	integer	No	20	Items per page. Maximum 100.
after_id	string	No	-	Cursor resource ID. Returns records after it. Cannot be used with before_id.
before_id	string	No	-	Cursor resource ID. Returns records before it. Cannot be used with after_id.

Example request

curl -s -X GET 'https://api.qoder.com/api/v1/forward/resources?type=skill&limit=20' \
  -H "Authorization: Bearer $QODER_PAT"

Example response

HTTP 200 OK

{
  "data": [
    {
      "id": "skill_xxx",
      "type": "skill",
      "owner_type": "user",
      "owner_id": "usr_xxx",
      "resource_spec": {
        "name": "customer-reply-skill",
        "description": "Customer reply policy skill",
        "type": "skill",
        "status": "active",
        "skill_type": "custom",
        "created_at": "2026-06-24T07:51:38.276624Z",
        "updated_at": "2026-06-24T07:51:38.276624Z",
        "metadata": {}
      }
    }
  ],
  "has_more": false,
  "first_id": "skill_xxx",
  "last_id": "skill_xxx"
}

Response fields

Field	Type	Description
data	array	Resource objects on the current page.
has_more	boolean	Whether more records remain.
first_id	string|null	Resource ID of the first item on this page.
last_id	string|null	Resource ID of the last item on this page.

Resource object fields

Field	Type	Description
id	string	Resource ID. Directly matches the resource ID.
type	string	Resource type.
owner_type	string	Ownership type. This endpoint filters to user.
owner_id	string	Owner ID for the current caller.
resource_spec	object	Flattened live resource object. Fields vary by type.

Errors

HTTP	Type	Trigger
400	invalid_request_error	Missing resource type.
400	invalid_request_error	Unsupported resource type.
400	invalid_request_error	limit out of range, or both after_id and before_id are provided.
401	authentication_error	PAT invalid or expired.

Notes

• Resources that are no longer visible are skipped; data may be smaller than the local registry record count.

Related

Register a resource

Create a template