MEmetorial
Provider Configs

List provider configs

Returns a paginated list of provider configs.

get/provider-configs

Request

  • Base URL
    https://api.metorial.com
  • Auth
    HTTP bearer

Query parameters

limitnumber
afterstring
beforestring
cursorstring
order'asc' | 'desc'
ownership'shared' | 'usable' | 'all'

Which resources to return under the resource ownership rules. 'shared' returns only resources that aren't owned, 'usable' returns shared resources plus owned resources the caller can use, 'all' returns every resource the caller can see. Defaults to 'shared' when ownership is enforced for the project and 'all' otherwise.

'active' | 'archived'
OR
string[]

Filter by status (active, archived)

string
OR
string[]

Filter by config ID(s)

string
OR
string[]

Filter by provider ID(s)

string
OR
string[]

Filter by provider specification ID(s)

string
OR
string[]

Filter by provider deployment ID(s)

available_for_useboolean

Only return configs that are not owned by another integration instance provider.

available_for_provider_deployment_idstring

Only return configs that are not locked to a different provider deployment.

string
OR
string[]

Filter by config vault ID(s)

string
OR
string[]

Filter by actor ID(s)

string
OR
string[]

Filter by consumer ID(s)

string
OR
string[]

Filter by identity ID(s)

string
OR
string[]

Filter by identity credential ID(s)

searchstring

Search by name or description

gtstring date-time

Only include records after this timestamp for provider config creation time

ltstring date-time

Only include records before this timestamp for provider config creation time

Filter provider config creation time by date range

gtstring date-time

Only include records after this timestamp for provider config last update time

ltstring date-time

Only include records before this timestamp for provider config last update time

Filter provider config last update time by date range

Headers

Metorial-Versionstring
Example:2025-01-01

Pin the dated API version for this request, e.g. 2025-01-01. Defaults to the version configured for the environment.

Response

Successful response

Example response

{
  "items": [
    {
      "id": "pcf_7dEfGhJkLmNpQrSt",
      "name": "Production Config",
      "description": "Configuration for production environment",
      "provider_id": "pro_5gHjKlMnPqRsTuVw",
      "specification_id": "psp_9gHjKlMnPqRsTuVw",
      "deployment": {
        "id": "pde_1aBcDeFgHjKlMnPq",
        "name": "Production",
        "description": "Production deployment",
        "provider_id": "pro_5gHjKlMnPqRsTuVw",
        "created_at": "2025-09-15T10:30:00.000Z",
        "updated_at": "2026-01-10T14:45:00.000Z"
      },
      "from_vault": {
        "id": "pcvt_3bCdEfGhJkLmNpQr",
        "name": "Production Secrets",
        "description": "Secure storage for production credentials",
        "provider_id": "pro_5gHjKlMnPqRsTuVw",
        "deployment": {
          "id": "pde_1aBcDeFgHjKlMnPq",
          "name": "Production",
          "description": "Production deployment",
          "provider_id": "pro_5gHjKlMnPqRsTuVw",
          "created_at": "2025-09-15T10:30:00.000Z",
          "updated_at": "2026-01-10T14:45:00.000Z"
        },
        "created_at": "2025-09-15T10:30:00.000Z",
        "updated_at": "2026-01-10T14:45:00.000Z"
      },
      "created_at": "2025-09-15T10:30:00.000Z",
      "updated_at": "2026-01-10T14:45:00.000Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.