Provider Auth Methods

An auth method defines one way to authenticate with a provider (OAuth, API token, or custom credentials). A provider version may support multiple auth methods.

Provider Auth Methods object

Attributes

object

String

String representing the object's type

id

String

Unique auth method identifier

type

Enum

Authentication type

key

String

Auth method key

name

String

Display name

description

StringNullable

Auth method description

capabilities

Object

Auth method capabilities

input_schema

ObjectNullable

output_schema

ObjectNullable

scopes

ObjectNullable

Available OAuth scopes

provider_id

String

Provider ID

provider_specification_id

String

Specification ID

created_at

Date

Timestamp when created

updated_at

Date

Timestamp when last updated

{
  "object": "provider.capabilities.auth_method",
  "id": "pam_2mNpQrStUvWxYzAb",
  "type": "oauth",
  "key": "oauth2",
  "name": "OAuth 2.0",
  "description": "Authenticate using OAuth 2.0",
  "capabilities": {},
  "input_schema": {
    "type": "json_schema",
    "schema": {}
  },
  "output_schema": {
    "type": "json_schema",
    "schema": {}
  },
  "scopes": [
    {
      "object": "provider.capabilities.auth_method.scope",
      "id": "pams_8tUvWxYzAbCdEfGh",
      "scope": "repo",
      "name": "Repository Access",
      "description": "Full control of private repositories"
    }
  ],
  "provider_id": "pro_5gHjKlMnPqRsTuVw",
  "provider_specification_id": "psp_9gHjKlMnPqRsTuVw",
  "created_at": "2025-09-15T10:30:00.000Z",
  "updated_at": "2026-01-10T14:45:00.000Z"
}

List provider auth methods

Returns a paginated list of provider auth methods.

Query Parameters

limit

NumberOptional

Maximum number of items to return (1-100)

after

StringOptional

Return items after this ID

before

StringOptional

Return items before this ID

cursor

StringOptional

Pagination cursor from a previous response

order

EnumOptional

Sort order for results

provider_version_id

String
GEThttp://api.metorial.com/provider-auth-methods
curl -X GET "https://api.metorial.com/provider-auth-methods" \
  -H "Authorization: Bearer metorial_sk_..."

Get provider auth method

Retrieves a specific provider auth method by ID.

URL Parameters

provider_auth_method_id

String

The unique identifier for the provider_auth_method

GEThttp://api.metorial.com/provider-auth-methods/:provider_auth_method_id
curl -X GET "https://api.metorial.com/provider-auth-methods/pro_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."