roles

Create a new organization role

Changed on Jul 17, 2026

Creates a new role within an organization.

post/organisations/{org_id}/roles

Request

Base URL
https://staging.api-golang.boilerplate.hng.tech/api/v1
Auth
HTTP bearer
TypeScript
https://skmtc.dev/hngprojects/apis/kimiko-golang-swagger/docs/organisations/:org_id/roles/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

org_idstring uuid required

ID of the organization to create the role in.

Request body

namestring required

Name of the role.

descriptionstring required

Description of the role.

Response

Role created successfully

statusstring

status_codeinteger

messagestring

Changes

Jul 17, 20262d1d3ed96bb9 Revision changes
- info
  endpoint added
Aug 7, 202406cecc2ac126 Revision changes
- breaking
  api path removed without deprecation

Operation history