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

Enumprovider.capabilities.auth_method

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

Array of ObjectsNullable

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"
    },
    {
      "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

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

provider_version_id

String
GEThttps://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

GEThttps://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_..."