marketplace-hire

2 endpoints from the published OpenAPI import.

POST/api/v1/marketplace/agents/{component_id}/hire

Hire Marketplace Agent

Hire an OPVS-employee marketplace tile (Feed B) → bound kind='agent' flow.

The tile's agent_meta.opvs_catalog.profile_id is the hire key. See :func:_hire_agent_flow for the shared bind/persist path.

Parameters

Name	In	Type	Required	Description
`component_id`	path	string	true

Try it

Examples

cURL

curl -X POST 'https://spideriq.ai/api/v1/marketplace/agents/{component_id}/hire' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "profile_id": "string",
  "project_id": "string",
  "flow_id": "string",
  "display_name": "string",
  "embed_origins": [
    "string"
  ]
}'

Python

import httpx

resp = httpx.post(
    "https://spideriq.ai/api/v1/marketplace/agents/{component_id}/hire",
    headers={"Authorization": "Bearer <token>", "Content-Type": "application/json"},
    json={"profile_id": "string", "project_id": "string", "flow_id": "string", "display_name": "string", "embed_origins": ["string"]},
)
resp.raise_for_status()
print(resp.json())

JavaScript

const resp = await fetch("https://spideriq.ai/api/v1/marketplace/agents/{component_id}/hire", {
  method: "POST",
  headers: { "Authorization": "Bearer <token>", "Content-Type": "application/json" },
  body: JSON.stringify({"profile_id": "string", "project_id": "string", "flow_id": "string", "display_name": "string", "embed_origins": ["string"]})
});
const data = await resp.json();
console.log(data);

package main

import (
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{"profile_id": "string", "project_id": "string", "flow_id": "string", "display_name": "string", "embed_origins": ["string"]}`)
	req, _ := http.NewRequest("POST", "https://spideriq.ai/api/v1/marketplace/agents/{component_id}/hire", body)
	req.Header.Set("Authorization", "Bearer <token>")
	req.Header.Set("Content-Type", "application/json")
	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
}

Responses

Status	Description
`200`	Successful Response
`422`	Validation Error

POST/api/v1/marketplace/agents/by-profile/{catalog_profile_id}/hire

Hire Marketplace Agent By Profile

Hire by OPVS catalog_profile_id (Feed A — the tenant's own roster, AG.2).

Binds directly by the OPVS profile id from GET /employees/hires; for an already-owned hire this is a FREE reuse (no 402). Same 200-envelope / persist path as the tile hire — see :func:_hire_agent_flow.