Salesforce Runs API

The Runs API from Salesforce — 3 operation(s) for runs.

Documentation GitHub OpenAPI

Business capability

Operations 1

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

POST /data/v64.0/tooling/runTestsSynchronous Run Apex tests synchronously · Salesforce Tooling Run Tests Sync #

Ask an LLM

“Can I run Apex tests and get the results in the same response?”

“Is there a way to run a test class and wait for it to finish?”

Tell an agent

Run my Apex tests synchronously.

Execute the Apex test class now and return results.

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/salesforce:salesforce-runs-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

openapi: 3.2.0
info:
  title: Salesforce Runs API
  description: Find the resources you need to start building.
  contact: {}
  version: '1.0'
servers:
- url: https://login.salesforce.com
  variables: {}
- url: https://id
  variables: {}
- url: https://services
  variables: {}
- url: '{{url}}{{site}}/services/oauth2'
  variables:
    url:
      default: DefaultParameterValue
    site:
      default: DefaultParameterValue
security:
- oauth2:
  - api
tags:
- name: Runs
paths:
  /data/v64.0/tooling/runTestsSynchronous:
    parameters: []
    post:
      tags:
      - Runs
      summary: Salesforce Tooling Run Tests Sync
      description: Runs one or more methods within one or more Apex classes, using the asynchronous test execution mechanism. In the request body, you can specify test class names and IDs, suite names and IDs, the maximum number of failed tests to allow, and the test level, as comma-separated lists or as an array. You can also indicate whether to opt out of collecting code coverage information during the test run (available in API version 43.0 and later).
      operationId: ToolingRunTestsSync
      parameters: []
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              type: string
              examples:
              - "[\n    {\n        \"className\": \"YourClassName\",\n        \"testMethods\": [\n            \"testMethod1\",\n            \"testMethod2\",\n            \"testMethod3\"\n        ]\n    },\n    {\n        \"maxFailedTests\": \"2\"\n    }\n]\n\nor\n\n{\n    \"tests\": [\n        {\n            \"className\": \"YourClassName\",\n            \"testMethods\": [\n                \"testMethod1\",\n                \"testMethod2\",\n                \"testMethod3\"\n            ]\n        }\n    ],\n    \"maxFailedTests\": \"integer value\",\n    \"testLevel\": \"TestLevel enum value\",\n    \"skipCodeCoverage\": \"boolean value\"\n}\n"
              contentMediaType: application/json
            example: "[\n    {\n        \"className\": \"YourClassName\",\n        \"testMethods\": [\n            \"testMethod1\",\n            \"testMethod2\",\n            \"testMethod3\"\n        ]\n    },\n    {\n        \"maxFailedTests\": \"2\"\n    }\n]\n\nor\n\n{\n    \"tests\": [\n        {\n            \"className\": \"YourClassName\",\n            \"testMethods\": [\n                \"testMethod1\",\n                \"testMethod2\",\n                \"testMethod3\"\n            ]\n        }\n    ],\n    \"maxFailedTests\": \"integer value\",\n    \"testLevel\": \"TestLevel enum value\",\n    \"skipCodeCoverage\": \"boolean value\"\n}\n"
        required: true
      responses:
        '200':
          description: OK
          headers:
            Date:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: Mon, 11 Dec 2023 09:59:37 GMT
            Strict-Transport-Security:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: max-age=63072000; includeSubDomains
            X-Content-Type-Options:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: nosniff
            X-Robots-Tag:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: none
            Cache-Control:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: no-cache,must-revalidate,max-age=0,no-store,private
            Sforce-Limit-Info:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: api-usage=246/15000
            Vary:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: Accept-Encoding
            Content-Encoding:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: gzip
            Transfer-Encoding:
              content:
                text/plain:
                  schema:
                    type: string
                    contentMediaType: text/plain
                  example: chunked
          content:
            application/json;charset=UTF-8:
              schema:
                allOf:
                - $ref: '#/components/schemas/ToolingRunTestsSync'
                - examples:
                  - apexLogId: 07L4H00000SpGroUAF
                    codeCoverage:
                    - id: 01q4H000000WjD8QAK
                      locationsNotCovered:
                      - {}
                      - {}
                      name: StateTrigger
                      namespace: null
                      numLocations: 2
                      numLocationsNotCovered: 2
                      type: Trigger
                    - id: 01q58000000RLTyAAO
                      locationsNotCovered:
                      - {}
                      - {}
                      - {}
                      name: RestrictContactByName
                      namespace: null
                      numLocations: 3
                      numLocationsNotCovered: 3
                      type: Trigger
                    - id: 01q58000000RLBhAAO
                      locationsNotCovered:
                      - {}
                      - {}
                      - {}
                      - {}
                      - {}
                      - {}
                      name: ClosedOpportunityTrigger
                      namespace: null
                      numLocations: 6
                      numLocationsNotCovered: 6
                      type: Trigger
                    - id: 01p4H000009PEFIQA4
                      locationsNotCovered:
                      - {}
                      - {}
                      name: PrepareSandbox
                      namespace: null
                      numLocations: 22
                      numLocationsNotCovered: 2
                      type: Class
                    codeCoverageWarnings:
                    - id: 01q4H000000WjD8QAK
                      message: Test coverage of selected Apex Trigger is 0%, at least 1% test coverage is required
                      name: StateTrigger
                      namespace: null
                    - id: 01q58000000RLTyAAO
                      message: Test coverage of selected Apex Trigger is 0%, at least 1% test coverage is required
                      name: RestrictContactByName
                      namespace: null
                    - id: 01q58000000RLBhAAO
                      message: Test coverage of selected Apex Trigger is 0%, at least 1% test coverage is required
                      name: ClosedOpportunityTrigger
                      namespace: null
                    - id: 01q4H000000WjD8QAK
                      message: Average test coverage across all Apex Classes and Triggers is 60%, at least 75% test coverage is required.
                      name: null
                      namespace: ''
                    failures: []
                    flowCoverage: []
                    flowCoverageWarnings: []
                    numFailures: 0
                    numTestsRun: 1
                    successes:
                    - id: 01p4H00000A0zYxQAJ
                      methodName: runApexClass_should_work
                      name: PrepareSandboxTest
                      namespace: null
                      seeAllData: false
                      time: 1088
                    totalTime: 1261
                contentMediaType: application/json;charset=UTF-8
              example:
                apexLogId: 07L4H00000SpGroUAF
                codeCoverage:
                - id: 01q4H000000WjD8QAK
                  locationsNotCovered:
                  - {}
                  - {}
                  name: StateTrigger
                  namespace: null
                  numLocations: 2
                  numLocationsNotCovered: 2
                  type: Trigger
                - id: 01q58000000RLTyAAO
                  locationsNotCovered:
                  - {}
                  - {}
                  - {}
                  name: RestrictContactByName
                  namespace: null
                  numLocations: 3
                  numLocationsNotCovered: 3
                  type: Trigger
                - id: 01q58000000RLBhAAO
                  locationsNotCovered:
                  - {}
                  - {}
                  - {}
                  - {}
                  - {}
                  - {}
                  name: ClosedOpportunityTrigger
                  namespace: null
                  numLocations: 6
                  numLocationsNotCovered: 6
                  type: Trigger
                - id: 01p4H000009PEFIQA4
                  locationsNotCovered:
                  - {}
                  - {}
                  name: PrepareSandbox
                  namespace: null
                  numLocations: 22
                  numLocationsNotCovered: 2
                  type: Class
                codeCoverageWarnings:
                - id: 01q4H000000WjD8QAK
                  message: Test coverage of selected Apex Trigger is 0%, at least 1% test coverage is required
                  name: StateTrigger
                  namespace: null
                - id: 01q58000000RLTyAAO
                  message: Test coverage of selected Apex Trigger is 0%, at least 1% test coverage is required
                  name: RestrictContactByName
                  namespace: null
                - id: 01q58000000RLBhAAO
                  message: Test coverage of selected Apex Trigger is 0%, at least 1% test coverage is required
                  name: ClosedOpportunityTrigger
                  namespace: null
                - id: 01q4H000000WjD8QAK
                  message: Average test coverage across all Apex Classes and Triggers is 60%, at least 75% test coverage is required.
                  name: null
                  namespace: ''
                failures: []
                flowCoverage: []
                flowCoverageWarnings: []
                numFailures: 0
                numTestsRun: 1
                successes:
                - id: 01p4H00000A0zYxQAJ
                  methodName: runApexClass_should_work
                  name: PrepareSandboxTest
                  namespace: null
                  seeAllData: false
                  time: 1088
                totalTime: 1261
      deprecated: false
      servers:
      - url: https://services
        variables: {}
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  schemas:
    CodeCoverageWarning:
      title: CodeCoverageWarning
      required:
      - id
      - message
      - name
      - namespace
      type: object
      properties:
        id:
          type: string
          example: abc123
        message:
          type: string
          example: example_value
        name:
          type:
          - string
          - 'null'
          example: Example Title
        namespace:
          type:
          - string
          - 'null'
          example: example_value
      examples:
      - id: 01q4H000000WjD8QAK
        message: Test coverage of selected Apex Trigger is 0%, at least 1% test coverage is required
        name: StateTrigger
        namespace: null
    ToolingRunTestsSync:
      title: ToolingRunTestsSync
      required:
      - apexLogId
      - codeCoverage
      - codeCoverageWarnings
      - failures
      - flowCoverage
      - flowCoverageWarnings
      - numFailures
      - numTestsRun
      - successes
      - totalTime
      type: object
      properties:
        apexLogId:
          type: string
          example: '500123'
        codeCoverage:
          type: array
          items:
            $ref: '#/components/schemas/CodeCoverage'
          description: ''
          example: []
        codeCoverageWarnings:
          type: array
          items:
            $ref: '#/components/schemas/CodeCoverageWarning'
          description: ''
          example: []
        failures:
          type: array
          items:
            type: string
          description: ''
          example: []
        flowCoverage:
          type: array
          items:
            type: string
          description: ''
          example: []
        flowCoverageWarnings:
          type: array
          items:
            type: string
          description: ''
          example: []
        numFailures:
          type: integer
          contentEncoding: int32
          example: 10
        numTestsRun:
          type: integer
          contentEncoding: int32
          example: 10
        successes:
          type: array
          items:
            $ref: '#/components/schemas/Success1'
          description: ''
          example: []
        totalTime:
          type: integer
          contentEncoding: int32
          example: 1700000000000
      examples:
      - apexLogId: 07L4H00000SpGroUAF
        codeCoverage:
        - id: 01q4H000000WjD8QAK
          locationsNotCovered:
          - {}
          - {}
          name: StateTrigger
          namespace: null
          numLocations: 2
          numLocationsNotCovered: 2
          type: Trigger
        - id: 01q58000000RLTyAAO
          locationsNotCovered:
          - {}
          - {}
          - {}
          name: RestrictContactByName
          namespace: null
          numLocations: 3
          numLocationsNotCovered: 3
          type: Trigger
        - id: 01q58000000RLBhAAO
          locationsNotCovered:
          - {}
          - {}
          - {}
          - {}
          - {}
          - {}
          name: ClosedOpportunityTrigger
          namespace: null
          numLocations: 6
          numLocationsNotCovered: 6
          type: Trigger
        - id: 01p4H000009PEFIQA4
          locationsNotCovered:
          - {}
          - {}
          name: PrepareSandbox
          namespace: null
          numLocations: 22
          numLocationsNotCovered: 2
          type: Class
        codeCoverageWarnings:
        - id: 01q4H000000WjD8QAK
          message: Test coverage of selected Apex Trigger is 0%, at least 1% test coverage is required
          name: StateTrigger
          namespace: null
        - id: 01q58000000RLTyAAO
          message: Test coverage of selected Apex Trigger is 0%, at least 1% test coverage is required
          name: RestrictContactByName
          namespace: null
        - id: 01q58000000RLBhAAO
          message: Test coverage of selected Apex Trigger is 0%, at least 1% test coverage is required
          name: ClosedOpportunityTrigger
          namespace: null
        - id: 01q4H000000WjD8QAK
          message: Average test coverage across all Apex Classes and Triggers is 60%, at least 75% test coverage is required.
          name: null
          namespace: ''
        failures: []
        flowCoverage: []
        flowCoverageWarnings: []
        numFailures: 0
        numTestsRun: 1
        successes:
        - id: 01p4H00000A0zYxQAJ
          methodName: runApexClass_should_work
          name: PrepareSandboxTest
          namespace: null
          seeAllData: false
          time: 1088
        totalTime: 1261
    CodeCoverage:
      title: CodeCoverage
      required:
      - id
      - locationsNotCovered
      - name
      - namespace
      - numLocations
      - numLocationsNotCovered
      - type
      type: object
      properties:
        id:
          type: string
          example: abc123
        locationsNotCovered:
          type: array
          items:
            type: object
          description: ''
          example: []
        name:
          type: string
          example: Example Title
        namespace:
          type:
          - string
          - 'null'
          example: example_value
        numLocations:
          type: integer
          contentEncoding: int32
          example: 10
        numLocationsNotCovered:
          type: integer
          contentEncoding: int32
          example: 10
        type:
          type: string
          example: example_value
      examples:
      - id: 01q4H000000WjD8QAK
        locationsNotCovered:
        - {}
        - {}
        name: StateTrigger
        namespace: null
        numLocations: 2
        numLocationsNotCovered: 2
        type: Trigger
    Success1:
      title: Success1
      required:
      - id
      - methodName
      - name
      - namespace
      - seeAllData
      - time
      type: object
      properties:
        id:
          type: string
          example: abc123
        methodName:
          type: string
          example: example_value
        name:
          type: string
          example: Example Title
        namespace:
          type:
          - string
          - 'null'
          example: example_value
        seeAllData:
          type: boolean
          example: true
        time:
          type: integer
          contentEncoding: int32
          example: 1700000000000
      examples:
      - id: 01p4H00000A0zYxQAJ
        methodName: runApexClass_should_work
        name: PrepareSandboxTest
        namespace: null
        seeAllData: false
        time: 1088
  securitySchemes:
    oauth2:
      type: oauth2
      flows:
        implicit:
          authorizationUrl: '{DefaultParameterValue}{DefaultParameterValue}/services/oauth2/authorize'
          scopes:
            api: ''