OutSystems

OutSystems Build API

The Build API from OutSystems — 4 operation(s) for build.

GitHub OpenAPI
Business capability
Continuous Integration Management BC-4210.10

Operations 6

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /build-operations/{operationKey} Get details of an asset build · Gets detailed information about a given build #
Ask an LLM
“How do I check the outcome of a build I started for an asset revision?”
“What details does ODC return for a single asset build operation?”
Tell an agent
Get the details of asset build {operationKey}.
Check whether build {operationKey} for my asset revision finished.
GET /build-operations/{operationKey}/log-messages Read an asset build's log messages · Gets messages logged by a given build #
Ask an LLM
“Why did my asset build fail, according to its log?”
“Can I read the messages logged while an asset revision was being built?”
Tell an agent
Show the log messages for asset build {operationKey}.
Get the build feedback logged by {operationKey}.
GET /build-operations/{operationKey}/generated-code Download a build's packaged generated code · Gets generated code produced by a given build #
Ask an LLM
“Where do I get the generated code once its packaging has finished?”
“Can I download the code a build produced for my asset?”
Tell an agent
Get the packaged generated code for build {operationKey}.
Download the generated code output of build {operationKey}.
POST /build-operations/{operationKey}/generated-code Start packaging a build's generated code · Starts packaging the code generated for a given build #
Ask an LLM
“How do I ask ODC to package the generated code of a build so I can download it?”
“What step must run before the generated code of a build is available?”
Tell an agent
Start packaging the generated code for build {operationKey}.
Prepare the generated code of build {operationKey} for download.
GET /build-operations List builds for an asset revision · List all builds created for a given revision of a given asset #
Ask an LLM
“What builds have been created for a given revision of my asset?”
“Can I filter an asset's builds by build type, such as Release?”
Tell an agent
List builds for asset {assetKey} revision {assetRevision}.
Show {byBuildType} builds created for asset {assetKey}.
POST /build-operations Start a build of an asset revision · Starts a job operation that will build a particular revision of a given asset #
Ask an LLM
“How do I trigger a Release build for a particular revision of an asset?”
“Which build types can I choose when building an asset revision?”
Tell an agent
Build revision {assetRevision} of asset {assetKey}.
Start a {buildType} build of asset {assetKey} at revision {assetRevision}.

Specifications

⚙
OpenAPI
https://artifacts.apis.io/outsystems/openapi/outsystems-build-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/outsystems/json-schema/outsystems-build-details-schema.json
📊
JSONSchema
https://artifacts.apis.io/outsystems/json-schema/outsystems-generated-code-package-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/outsystems/json-schema/outsystems-build-operation-details-schema.json
📊
JSONSchema
https://artifacts.apis.io/outsystems/json-schema/outsystems-build-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/outsystems/json-schema/outsystems-generated-code-packaging-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/outsystems/json-schema/outsystems-build-feedback-details-response-schema.json

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/outsystems:outsystems-build-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

outsystems-build-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Operations Build API
  description: Provides APIs to start build operations and retrieve information about their status.
  version: v1
servers:
- url: https://ODC_PORTAL_DOMAIN/api/builds/v1
  description: Replace ODC_PORTAL_DOMAIN with the domain of your organization.
- url: https://{odc-portal-domain}/api/builds/v1
  description: Replace {odc-portal-domain} with the domain of your organization.
  variables:
    '{odc-portal-domain}':
      default: '{odc-portal-domain}'
      description: The domain of your organization
security:
- bearerAuth: []
tags:
- name: Build
paths:
  /build-operations/{operationKey}:
    get:
      tags:
      - Build
      summary: Gets detailed information about a given build
      description: 'Example:


        GET /builds/v1/build-operations/be77b25f-c738-462f-8f19-7114fc4f9923


        You need the **Asset management > Open** permission.'
      operationId: BuildV_GetBuild
      parameters:
      - name: operationKey
        in: path
        description: The key of the build
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: Details about the build
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BuildDetails'
        '404':
          description: Couldn't find asset key or revision or build
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
      x-os-permissions: You need the **Asset management > Open** permission.
  /build-operations/{operationKey}/log-messages:
    get:
      tags:
      - Build
      summary: Gets messages logged by a given build
      description: 'Example:


        GET /builds/v1/build-operations/be77b25f-c738-462f-8f19-7114fc4f9923/log-messages


        You need the **Asset management > Open** permission.'
      operationId: BuildV_GetBuildFeedback
      parameters:
      - name: operationKey
        in: path
        description: The key of the build
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BuildFeedbackDetailsResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
      x-os-permissions: You need the **Asset management > Open** permission.
  /build-operations/{operationKey}/generated-code:
    get:
      tags:
      - Build
      summary: Gets generated code produced by a given build
      description: 'This resource is only available after calling POST /build-operations/{operationKey}/generated-code with the respective build key.


        Example:


        GET /builds/v1/build-operations/be77b25f-c738-462f-8f19-7114fc4f9923/generated-code


        You need the **Asset management > Open** permission.'
      operationId: BuildV_GetSourceCode
      parameters:
      - name: operationKey
        in: path
        description: The key of the build
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: Details about the generated code
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeneratedCodePackageResponse'
        '404':
          description: Couldn't find generated code package for the given build
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
      x-os-permissions: You need the **Asset management > Open** permission.
    post:
      tags:
      - Build
      summary: Starts packaging the code generated for a given build
      description: 'Example:


        POST /builds/v1/build-operations/be77b25f-c738-462f-8f19-7114fc4f9923/generated-code


        You need the **Asset management > Open** permission.'
      operationId: BuildV_StartSourceCodeProcess
      parameters:
      - name: operationKey
        in: path
        description: The key of the build
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '201':
          description: Indicates whether the packaging was initiated successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GeneratedCodePackagingResponse'
        '404':
          description: Couldn't find build
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '422':
          description: Build is not valid for generated code packaging
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
      x-os-permissions: You need the **Asset management > Open** permission.
  /build-operations:
    get:
      tags:
      - Build
      summary: List all builds created for a given revision of a given asset
      description: 'Example:


        GET /builds/v1/build-operations?assetKey=68ef84e5-9265-47b8-8612-b073b70e3e3e&assetRevision=1


        You need the **Asset management > Open** permission.'
      operationId: BuildV_ListBuilds
      parameters:
      - name: assetKey
        in: query
        description: The key of the asset
        schema:
          type: string
          format: uuid
      - name: assetRevision
        in: query
        description: The id of the revision of the asset
        schema:
          type: integer
          format: int32
      - name: byBuildType
        in: query
        description: 'Filter by build type. Default: returns all'
        schema:
          allOf:
          - $ref: '#/components/schemas/BuildType'
      responses:
        '200':
          description: The list of all builds
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BuildDetailsBuildListResponse'
        '404':
          description: Couldn't find asset key or revision
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
      x-os-permissions: You need the **Asset management > Open** permission.
    post:
      tags:
      - Build
      summary: Starts a job operation that will build a particular revision of a given asset
      description: 'Example:


        POST /builds/v1/build-operations


        {


        "buildType": "Release",


        "assetKey": "68ef84e5-9265-47b8-8612-b073b70e3e3e",


        "assetRevision": 1


        }


        You need the **Asset management > Open** permission.'
      operationId: BuildV_StartNewBuildJob
      requestBody:
        description: The specification of the build to start, including asset key, asset revision, and build type.
        content:
          application/json:
            schema:
              allOf:
              - $ref: '#/components/schemas/BuildOperationDetails'
              description: The specification of a build request
          application/*+json:
            schema:
              allOf:
              - $ref: '#/components/schemas/BuildOperationDetails'
              description: The specification of a build request
      responses:
        '201':
          description: The Id of the build that was just started
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BuildResponse'
        '404':
          description: Couldn't find asset or revision
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '400':
          description: BuildType is invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
      x-os-permissions: You need the **Asset management > Open** permission.
components:
  schemas:
    BuildResponse:
      type: object
      properties:
        buildKey:
          type: string
          description: A unique identifier generated for the Build. Can be used to retrieve or outputs the status of associated build.
          format: uuid
        isSuccessful:
          type: boolean
          description: Signals whether the build start successfully
      additionalProperties: false
      description: The response of a build request
    BuildFeedbackDetails:
      type: object
      properties:
        timestamp:
          type: string
          description: The timestamp representing the instant when the message was issued
          format: date-time
        type:
          type:
          - string
          - 'null'
          description: An identifier for the message
        severity:
          type:
          - string
          - 'null'
          description: 'The severity of the message: Error, Info, Warning, etc.'
        message:
          type:
          - string
          - 'null'
          description: The content of the message
        stepId:
          type:
          - string
          - 'null'
          description: The identifier of the stage the message corresponds to
        assetKey:
          type: string
          description: The key of the application being processed by the build
          format: uuid
        errorCode:
          type:
          - string
          - 'null'
          description: A unique identifier for the error message
      additionalProperties: false
      description: A message issued during the build process
    GeneratedCodePackageResponse:
      type: object
      properties:
        status:
          allOf:
          - $ref: '#/components/schemas/GeneratedCodePackagingStatus'
          description: The current status of the packaging.
        uri:
          type:
          - string
          - 'null'
          description: The URI of the generated code package.
        errors:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/GeneratedCodePackagingError'
          description: The list of errors that occurred while packaging.
      additionalProperties: false
      description: Represents the result of packaging a build's generated code.
    SecurityVulnerabilities:
      type: object
      properties:
        vulnerabilities:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/SecurityVulnerability'
          description: A list of the security vulnerabilities
      additionalProperties: false
      description: Security Vulnerabilities
    BuildDetails:
      required:
      - assetKey
      - assetRevision
      - buildKey
      - buildType
      type: object
      properties:
        buildKey:
          type: string
          description: The key of build
          format: uuid
        assetKey:
          type: string
          description: The particular asset being built
          format: uuid
        assetRevision:
          type: integer
          description: The particular revision being built
          format: int32
        buildType:
          allOf:
          - $ref: '#/components/schemas/BuildType'
          description: The type of build
        startedDateTime:
          type:
          - string
          - 'null'
          description: The timestamp, in UTC, of when the built was started
          format: date-time
        finishedDateTime:
          type:
          - string
          - 'null'
          description: The timestamp, in UTC, of when the built was finished
          format: date-time
        builtBy:
          type:
          - string
          - 'null'
          description: The key of the subject (user, service account, etc.) which requested the build
        status:
          allOf:
          - $ref: '#/components/schemas/BuildStatus'
          description: The current status of the build
        securityAudit:
          allOf:
          - $ref: '#/components/schemas/SecurityVulnerabilities'
          description: The Security audit with list of security vulnerabilities
      additionalProperties: false
      description: The status of a particular build
    GeneratedCodePackagingStatus:
      enum:
      - NotStarted
      - Running
      - Finished
      - TimedOut
      - Failed
      type: string
    BuildStatus:
      enum:
      - Pending
      - Finished
      - FinishedWithErrors
      - Running
      - Deleted
      - ToBeDeleted
      type: string
    GeneratedCodePackagingResponse:
      type: object
      properties:
        isSuccessful:
          type: boolean
          description: Indicates whether the packaging was initiated successfully.
      additionalProperties: false
      description: Represents the response from initiating the packaging of a build's generated code.
    BuildDetailsBuildListResponse:
      type: object
      properties:
        builds:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/BuildDetails'
          description: The list of builds
      additionalProperties: false
      description: The list of builds that match provided criteria
    BuildOperationDetails:
      type: object
      properties:
        assetKey:
          type: string
          description: Specifies the key of the asset to be built
          format: uuid
        assetRevision:
          type: integer
          description: Specifies the revision of the asset to be built
          format: int32
        buildType:
          allOf:
          - $ref: '#/components/schemas/BuildType'
          description: 'Specifies the type of build to be created. Accepts: ''Debug'' or ''Release'''
          default: Debug
      additionalProperties: false
      description: The specification of a build request
    BuildFeedbackDetailsResponse:
      type: object
      properties:
        results:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/BuildFeedbackDetails'
          description: The messages issued during a build
      additionalProperties: false
      description: All messages issued during a build
    ProblemDetails:
      type: object
      properties:
        type:
          type:
          - string
          - 'null'
          description: A URI reference that identifies the problem type.
        title:
          type:
          - string
          - 'null'
          description: A short, human-readable summary of the problem.
        status:
          type:
          - integer
          - 'null'
          description: The HTTP status code applicable to the problem.
          format: int32
        detail:
          type:
          - string
          - 'null'
          description: A human-readable explanation of the error.
        instance:
          type:
          - string
          - 'null'
          description: A URI that identifies the specific occurrence of the problem.
        traceId:
          type: string
          description: This field helps OutSystems support track and investigate specific error occurrences. Providing this identifier when reporting an issue allows for more precise and faster troubleshooting.
        errorCode:
          type: string
          description: This error code serves the purpose to communicate with OutSystems Support and help diagnose errors.
      description: A standardized error response as per RFC 7807 (Problem Details for HTTP APIs).
    SecurityVulnerability:
      type: object
      properties:
        id:
          type:
          - string
          - 'null'
          description: The Id the vulnerability
        severity:
          type:
          - string
          - 'null'
          description: The Severity level of the vulnerability
        details:
          type:
          - string
          - 'null'
          description: The Link to the vulnerability description
        publishedDate:
          type: string
          description: The Published date of the vulnerability
          format: date-time
      additionalProperties: false
      description: Security Vulnerability
    BuildType:
      enum:
      - Debug
      - Release
      type: string
      description: The type of build
    GeneratedCodePackagingError:
      type: object
      properties:
        timestamp:
          type: string
          description: The timestamp representing the instant when the message was issued
          format: date-time
        severity:
          type:
          - string
          - 'null'
          description: 'The severity of the error: Error, Info, Warning, etc.'
        message:
          type:
          - string
          - 'null'
          description: The content of the error
      additionalProperties: false
      description: A message issued during the packaging of a build's generated code
  securitySchemes:
    bearerAuth:
      type: http
      description: Enter your bearer token in the format 'Bearer {token}'
      scheme: bearer
      bearerFormat: JWT