action salesforce_soql_query {
  label: "Run a SOQL query"
  description: "Executes a SOQL query via the REST query endpoint and returns the matching records. Follow `nextRecordsUrl` with further requests when `done` is false.\n\nRequired scopes: `api`."
  provider: salesforce
  method: GET
  path: "/services/data/v64.0/query"
  encoding: query
  scopes: ["api"]
  input: {
    type: "object"
    properties: {
      q: {
        type: "string"
        description: "The SOQL query to execute, e.g. `SELECT Id, Name FROM Account LIMIT 10`."
      }
    }
    required: ["q"]
    additionalProperties: false
  }
  output: {
    type: "object"
    required: ["totalSize", "done", "records"]
    properties: {
      totalSize: {
        type: "number"
        description: "Total number of records matching the query."
      }
      done: {
        type: "boolean"
        description: "True when this response contains the full result set."
      }
      nextRecordsUrl: {
        type: "string"
        description: "Path to the next batch of records when `done` is false."
      }
      records: {
        type: "array"
        description: "The matching records, each with an `attributes` object and the selected fields."
        items: {
          type: "object"
        }
      }
    }
  }
}