Credo AI

Credo AI Use Case Risk Scenarios API

Operations related to risk scenarios for a specific use case

GitHub OpenAPI
Business capability
Risk Identification & Assessment BC-120.20

Operations 5

DELETE /use_cases/{use_case_id}/risk_scenarios/{id} Credo AI web API V2 use case risk scenario controller delete #
GET /use_cases/{use_case_id}/risk_scenarios/{id} Credo AI web API V2 use case risk scenario controller show #
PATCH /use_cases/{use_case_id}/risk_scenarios/{id} Credo AI web API V2 use case risk scenario controller update #
GET /use_cases/{use_case_id}/risk_scenarios Credo AI web API V2 use case risk scenario controller index #
POST /use_cases/{use_case_id}/risk_scenarios Credo AI web API V2 use case risk scenario controller create #

Documentation

📖
Documentation
https://docs.sdk.credo.ai/docs/intro/
📖
APIReference
https://docs.sdk.credo.ai/docs/api-reference
📖
GettingStarted
https://docs.sdk.credo.ai/docs/getting-started
📖
Authentication
https://artifacts.apis.io/credo-ai/authentication/credo-ai-authentication.yml
📖
Documentation
https://api.credo.ai/openapi

Specifications

⚙
OpenAPI
https://artifacts.apis.io/credo-ai/openapi/credo-ai-use-case-risk-scenarios-api-openapi.yml

Other Resources

🔗
Swagger
https://api.credo.ai/swagger.json
🔗
Conventions
https://artifacts.apis.io/credo-ai/conventions/credo-ai-conventions.yml
🔗
ErrorCatalog
https://artifacts.apis.io/credo-ai/errors/credo-ai-problem-types.yml
🔗
DataModel
https://artifacts.apis.io/credo-ai/data-model/credo-ai-data-model.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/credo-ai:credo-ai-use-case-risk-scenarios-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

credo-ai-use-case-risk-scenarios-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: Credo AI server API
  title: Credo AI server Use Case Risk Scenarios API
servers:
- url: /api/v2/credoai
tags:
- name: use_case_risk_scenarios
  description: Operations related to risk scenarios for a specific use case
paths:
  /use_cases/{use_case_id}/risk_scenarios/{id}:
    delete:
      description: Deletes the specified risk scenario from the use case.
      operationId: CredoAIWeb.API.V2.UseCase.RiskScenarioController.delete
      parameters:
      - description: The ID of the use case.
        in: path
        name: use_case_id
        required: true
        schema:
          type: string
      - description: The ID of the risk scenario.
        in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '204':
          description: No Content
        '401':
          description: Unauthorized
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/AuthError'
        '403':
          description: Forbidden
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/ForbiddenError'
        '404':
          description: Not Found
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/NotFoundError'
      security:
      - Bearer: []
      summary: Credo AI web API V2 use case risk scenario controller delete
      tags:
      - use_case_risk_scenarios
      x-summary-source: derived
    get:
      description: Retrieves detailed information about a specific risk scenario associated with the given use case.
      operationId: CredoAIWeb.API.V2.UseCase.RiskScenarioController.show
      parameters:
      - description: The ID of the risk scenario.
        in: path
        name: id
        required: true
        schema:
          type: string
      - description: The ID of the use case.
        in: path
        name: use_case_id
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/UseCaseRiskScenarioResponse'
        '401':
          description: Unauthorized
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/AuthError'
        '404':
          description: Not Found
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/NotFoundError'
      security:
      - Bearer: []
      summary: Credo AI web API V2 use case risk scenario controller show
      tags:
      - use_case_risk_scenarios
      x-summary-source: derived
    patch:
      description: Updates the attributes of an existing risk scenario.
      operationId: CredoAIWeb.API.V2.UseCase.RiskScenarioController.update
      parameters:
      - description: The ID of the risk scenario.
        in: path
        name: id
        required: true
        schema:
          type: string
      - description: The ID of the use case.
        in: path
        name: use_case_id
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/UseCaseRiskScenarioResponse'
        '401':
          description: Unauthorized
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/AuthError'
        '403':
          description: Forbidden
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/ForbiddenError'
        '404':
          description: Not Found
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/NotFoundError'
      security:
      - Bearer: []
      summary: Credo AI web API V2 use case risk scenario controller update
      tags:
      - use_case_risk_scenarios
      requestBody:
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/UseCaseRiskScenarioUpdateRequest'
        description: The updated attributes for the risk scenario.
      x-summary-source: derived
  /use_cases/{use_case_id}/risk_scenarios:
    get:
      description: Retrieves a list of all risk scenarios associated with the specified use case
      operationId: CredoAIWeb.API.V2.UseCase.RiskScenarioController.index
      parameters:
      - description: The ID of the use case.
        in: path
        name: use_case_id
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/UseCasesRiskScenariosResponse'
        '401':
          description: Unauthorized
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/AuthError'
        '404':
          description: Not Found
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/NotFoundError'
      security:
      - Bearer: []
      summary: Credo AI web API V2 use case risk scenario controller index
      tags:
      - use_case_risk_scenarios
      x-summary-source: derived
    post:
      description: 'Creates a new risk scenario for the specified use case. Options include:

        1. Creating a new scenario with a name and risk type.

        2. Referencing an existing scenario using its ID.'
      operationId: CredoAIWeb.API.V2.UseCase.RiskScenarioController.create
      parameters:
      - description: The ID of the use case.
        in: path
        name: use_case_id
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Created
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/UseCaseRiskScenarioResponse'
        '400':
          description: Bad Request
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/UseCaseRiskAlreadyExistError'
        '401':
          description: Unauthorized
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/AuthError'
        '403':
          description: Forbidden
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/ForbiddenError'
        '404':
          description: Not Found
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/NotFoundError'
      security:
      - Bearer: []
      summary: Credo AI web API V2 use case risk scenario controller create
      tags:
      - use_case_risk_scenarios
      requestBody:
        content:
          application/vnd.api+json:
            schema:
              $ref: '#/components/schemas/UseCaseRiskScenarioCreateRequest'
        description: The attributes for the new risk scenario.
      x-summary-source: derived
components:
  schemas:
    UseCaseRiskScenarioResource:
      description: ''
      properties:
        attributes:
          properties:
            description:
              description: ''
              type: string
            entity_id:
              description: ''
              type: string
            inherent_risk:
              description: ''
              type: string
            inherent_risk_impact:
              description: ''
              type: string
            inherent_risk_likelihood:
              description: ''
              type: string
            inserted_at:
              description: ''
              type: string
            name:
              description: ''
              type: string
            residual_risk:
              description: ''
              type: string
            residual_risk_impact:
              description: ''
              type: string
            residual_risk_likelihood:
              description: ''
              type: string
            risk_scenario_id:
              description: ''
              type: string
            risk_type_ids:
              description: ''
              type: string
            updated_at:
              description: ''
              type: string
            use_case_id:
              description: ''
              type: string
          type: object
        id:
          description: The JSON-API resource ID
          example: 64YUaLWSviHgibJaRWr3ZE
          type: string
        relationships:
          properties:
            risk_control_links:
              properties:
                data:
                  properties:
                    id:
                      description: Related risk_control_links resource id
                      type: string
                    type:
                      description: Type of related risk_control_links resource
                      type: string
                  type: object
              type: object
            risk_scenario:
              properties:
                data:
                  properties:
                    id:
                      description: Related risk_scenario resource id
                      type: string
                    type:
                      description: Type of related risk_scenario resource
                      type: string
                  type: object
              type: object
          type: object
        type:
          description: The JSON-API resource type
          example: use_case_risk_scenarios
          type: string
      type: object
    UseCaseRiskScenarioResponse:
      description: A JSON-API document with a single [UseCaseRiskScenarioResource](#usecaseriskscenarioresource) resource
      properties:
        data:
          $ref: '#/components/schemas/UseCaseRiskScenarioResource'
        included:
          description: Included resources
          items:
            properties:
              id:
                description: The JSON-API resource ID
                type: string
              type:
                description: The JSON-API resource type
                type: string
            type: object
          type: array
      required:
      - data
      type: object
    ForbiddenError:
      properties:
        errors:
          description: Errors
          items:
            properties:
              code:
                description: an application-specific error code, expressed as a string value.
                type: integer
              detail:
                description: a human-readable explanation specific to this occurrence of the problem. Like title, this field’s value can be localized.
                type: string
              title:
                description: a short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.
                type: string
            type: object
          type: array
      type: object
    UseCaseRiskScenarioUpdateRequest:
      description: ''
      properties:
        data:
          description: ''
          properties:
            attributes:
              properties:
                description:
                  description: risk scenario description
                  type: string
                inherent_risk_impact:
                  description: inherent risk impact(1-5)
                  example: 1
                  type: integer
                inherent_risk_likelihood:
                  description: inherent risk likelihood(1-5)
                  example: 1
                  type: integer
                name:
                  description: risk scenario name
                  type: string
                residual_risk_impact:
                  description: residual risk impact(1-5)
                  example: 1
                  type: integer
                residual_risk_likelihood:
                  description: residual risk likelihood(1-5)
                  example: 1
                  type: integer
                risk_type_ids:
                  description: risk type ids
                  example:
                  - NkBkDB9i64w53eVR6ssfzj
                  type: array
                type:
                  description: risk type
                  example: abuse_misuse
                  type: string
              type: object
            id:
              description: The JSON-API resource ID
              example: 64YUaLWSviHgibJaRWr3ZE
              type: string
            type:
              description: The JSON-API resource type
              example: resource-type
              type: string
          type: object
      type: object
    NotFoundError:
      properties:
        errors:
          description: Errors
          items:
            properties:
              code:
                description: an application-specific error code, expressed as a string value.
                type: integer
              detail:
                description: a human-readable explanation specific to this occurrence of the problem. Like title, this field’s value can be localized.
                type: string
              title:
                description: a short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.
                type: string
            type: object
          type: array
      type: object
    AuthError:
      properties:
        errors:
          description: Errors
          items:
            properties:
              code:
                description: an application-specific error code, expressed as a string value.
                type: integer
              detail:
                description: a human-readable explanation specific to this occurrence of the problem. Like title, this field’s value can be localized.
                type: string
              title:
                description: a short, human-readable summary of the problem that SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.
                type: string
            type: object
          type: array
      type: object
    UseCasesRiskScenariosResponse:
      description: A collection of [UseCaseRiskScenarioResource](#usecaseriskscenarioresource)
      properties:
        data:
          description: Content with [UseCaseRiskScenarioResource](#usecaseriskscenarioresource) objects
          items:
            $ref: '#/components/schemas/UseCaseRiskScenarioResource'
          type: array
      required:
      - data
      type: object
    UseCaseRiskScenarioCreateRequest:
      description: ''
      properties:
        data:
          description: ''
          properties:
            attributes:
              properties:
                description:
                  description: risk scenario description
                  type: string
                inherent_risk_impact:
                  description: inherent risk impact(1-5)
                  example: 1
                  type: integer
                inherent_risk_likelihood:
                  description: inherent risk likelihood(1-5)
                  example: 1
                  type: integer
                name:
                  description: risk scenario name
                  type: string
                risk_scenario_id:
                  description: risk scenario id
                  example: 8zA2nPjVSenyvcc429LPDT
                  type: string
                risk_type_ids:
                  description: risk type ids
                  example:
                  - NkBkDB9i64w53eVR6ssfzj
                  type: array
                type:
                  description: risk type
                  example: abuse_misuse
                  type: string
              type: object
            type:
              description: The JSON-API resource type
              example: resource-type
              type: string
          type: object
      type: object
  securitySchemes:
    Bearer:
      in: header
      name: Authorization
      type: apiKey
x-provenance:
  method: harvested
  publisher: Credo AI
  source: https://api.credo.ai/swagger.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)