Resolve endpoint to action

Resolve an API endpoint (path + method) to its corresponding action for authorization.

Authorization Middleware: This endpoint is primarily used by authorization middleware to determine which action should be checked for a given API request.

Path Matching: Supports exact matches and pattern matching with path parameters (e.g., /api/v1/users/{user_id} matches /api/v1/users/123).

Method Matching: HTTP method must match exactly (case-sensitive).

Use Cases:

• Authorization middleware determining required permissions
• API gateway integration for access control
• Dynamic permission checking in applications
• Audit logging of permission requirements

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

path · string · required

The API path to resolve (e.g., '/api/v1/users/123')

method · string · required

The HTTP method

Response

200

application/json

Mapping found and resolved successfully

Response model for mapping resolution (used by authorization middleware).

mapping_id · integer · required

Unique identifier of the mapping

Example:

1

action · string · required

Action name mapped to this endpoint

Example:

"user:read"

path_pattern · string · required

URL path pattern that matched

Example:

"/api/v1/users/{user_id}"

method · string · required

HTTP method

Example:

"GET"

description · string | null

Mapping description

Example:

"Get user profile information"