Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Weblate roles API

The roles API from Weblate — 2 operation(s) for roles.

Weblate roles API is one of 21 APIs that Weblate publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include roles. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 6 operations across 2 paths, and defines 35 schemas. It is described by OpenAPI 3.1.1.

Requests are made against a single base URL, http:.

6 operations 2 paths 35 schemas 1 DELETE2 GET1 PATCH1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.1
Base URL
https://hosted.weblate.org/api/
Authentication
API Key, API Key, API Key
Resource Areas
1

Authentication & Security 3

Weblate roles API declares 3 security schemes for authenticating requests. An API key is passed in the header as Bearer (bearerAuth). An API key is passed in the cookie as sessionid (cookieAuth). An API key is passed in the header as Token (tokenAuth).

  • bearerAuth — Token-based authentication with required prefix Bearer. - Each user has a personal access token which they can get from their respective user profile. These to…
  • cookieAuth — Session-based authentication used when user is signed in.
  • tokenAuth — Token-based authentication with required prefix Token. - Each user has a personal access token which they can get from their respective user profile. These tok…

Paths & Operations 6

Across 2 paths, the API surfaces 6 operations — 1 DELETE, 2 GET, 1 PATCH, 1 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

roles 6
GET
/api/roles/
Return a list of all roles associated with the user.
api_roles_list 2 params → 400401403404405406423429
POST
/api/roles/
Create a new role.
api_roles_create body → 400401403404405406415423
GET
/api/roles/{id}/
Return information about a role.
api_roles_retrieve 1 param → 400401403404405406423429
PUT
/api/roles/{id}/
Change the role parameters.
api_roles_update 1 param body → 400401403404405406415423
PATCH
/api/roles/{id}/
Change the role parameters.
api_roles_partial_update 1 param body → 400401403404405406415423
DELETE
/api/roles/{id}/
Delete a role.
api_roles_destroy 1 param → 400401403404405406423429

Schemas 35

The contract defines 35 schemas that model the data the API accepts and returns. The most detailed are PaginatedRoleList (4 properties), Role (4 properties), PatchedRole (4 properties), Error405 (3 properties). Each schema is shown below with its type and property counts.

Error415
object
3 properties 3 required
ErrorCode406Enum
string
notacceptable - Not Acceptable
Error423
object
3 properties 3 required
PatchedRole
object
4 properties
ErrorResponse403
object
2 properties 2 required
ErrorResponse404
object
2 properties 2 required
ErrorCode429Enum
string
throttled - Throttled
ErrorCode401Enum
string
authenticationfailed - Authentication Failed notauthenticated - Not Authenticated
ErrorCode403Enum
string
permissiondenied - Permission Denied
ErrorResponse415
object
2 properties 2 required
Error429
object
3 properties 3 required
Error406
object
3 properties 3 required
Error405
object
3 properties 3 required
Error400
object
3 properties 3 required
Error401
object
3 properties 3 required
ErrorResponse400TypeEnum
string
validationerror - Validation Error clienterror - Client Error
Error500
object
3 properties 3 required
ErrorCode500Enum
string
error - Error
Role
object
4 properties 4 required
ServerErrorEnum
string
servererror - Server Error
Error404
object
3 properties 3 required
ErrorCode415Enum
string
unsupportedmediatype - Unsupported Media Type
PaginatedRoleList
object
4 properties 2 required
ErrorCode404Enum
string
notfound - Not Found
ErrorResponse500
object
2 properties 2 required
ErrorResponse423
object
2 properties 2 required
Error403
object
3 properties 3 required
ErrorResponse401
object
2 properties 2 required
ErrorResponse429
object
2 properties 2 required
ErrorCode423Enum
string
repository-locked - Repository Locked component-locked - Component Locked unknown-locked - Unknown Locked
ErrorResponse400
object
2 properties 2 required
ErrorResponse406
object
2 properties 2 required
ErrorResponse405
object
2 properties 2 required
ErrorCode405Enum
string
methodnotallowed - Method Not Allowed
ClientErrorEnum
string
clienterror - Client Error

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

weblate-roles-api-openapi.yml Raw ↑

Other APIs Weblate publishes across the network.

Weblate addons API
Weblate categories API
Weblate changes API
Weblate component-lists API
Weblate components API
Weblate contributions API
Weblate groups API
Weblate hooks API
Weblate languages API
Weblate memory API
Weblate metrics API
Weblate projects API