Skip to content
トレカクラウド
Esc
↑↓navigate↵open⌘Jpreview

Move a unit within a site

Moves to an active shelf in the same site. Already there returns moved=false. Another site fails with different_site; use transfers. In addition to inventory:read, this needs its operation scope and the approving member’s inventory.write permission.

POST/inventory/items/{id}/move
Authorization
AuthorizationOAuth2 access token · headerrequired

Authorization code flow (PKCE S256 required). Send resource=https://api.toreca-cloud.com/partner/v1 with the authorization, token and refresh requests. Access tokens last 15 minutes; refresh tokens last 90 days and rotate on every refresh.

Scopes:inventory:readinventory:move
Path parameters
idstring<uuid>required
Request body
requiredapplication/json
toLocationIdstring<uuid>required
reasonstringrequired
min length 1 · max length 2000
Responses
200

Success

movedbooleanrequired
itemInventoryItemrequired
Show properties
idstring<uuid>required
createdAtstring<date-time>required
updatedAtstring<date-time>required
assetNumberstringrequired
sourceKindstringrequired
Allowed:purchasereceipttenant_transfer
statusstringrequired
versionintegerrequired
siteIdstring<uuid> | nullrequired
Show properties
One of:
string<uuid>
string<uuid>
null
null
locationIdstring<uuid> | nullrequired
Show properties
One of:
string<uuid>
string<uuid>
null
null
gradeobject | nullrequired
Show properties
One of:
object
serviceCodestringrequired
serviceNamestringrequired
serviceKindstringrequired
Allowed:third_partyinternal
codestringrequired
labelstringrequired
numericScorenumber | nullrequired
Show properties
One of:
number
number
null
null
null
null
certificationNumberstring | nullrequired
Show properties
One of:
string
string
null
null
certificationVerifiedbooleanrequired
conditionNotestring | nullrequired
Show properties
One of:
string
string
null
null
acquisitionAmountMinorinteger | nullrequired
Show properties
One of:
integer
integer
null
null
currencystringrequired
acquiredAtstring<date-time>required
lastMovedAtstring<date-time>required
allocationstringrequired
Allowed:yoursothersnone
holdablebooleanrequired
commitmentobject | nullrequired
Show properties
One of:
object
idstring<uuid>required
purposestringrequired
Allowed:oripasale
labelstringrequired
externalRefstring | nullrequired
Show properties
One of:
string
string
null
null
null
null
marketValueMarketValue | nullrequired
Show properties
One of:
MarketValue
amountMinorintegerrequired
currencystringrequired
pricedAtstring<date-time>required
null
null
conditionTagsobject[]required
Show properties
Array of object
idstring<uuid>required
namestringrequired
photosobjectrequired
Show properties
frontobject | nullrequired
Show properties
One of:
object
urlstring<uri>required
updatedAtstring<date-time>required
null
null
backobject | nullrequired
Show properties
One of:
object
urlstring<uri>required
updatedAtstring<date-time>required
null
null
cardobjectrequired
Show properties
idstring<uuid>required
namestringrequired
localizedNamesobjectrequired
cardNumberstring | nullrequired
Show properties
One of:
string
string
null
null
languageCodestringrequired
variantstring | nullrequired
Show properties
One of:
string
string
null
null
finishstring | nullrequired
Show properties
One of:
string
string
null
null
imageUrlstring | nullrequired
Show properties
One of:
string
string
null
null
rarityobject | nullrequired
Show properties
One of:
object
codestringrequired
namestringrequired
null
null
setobject | nullrequired
Show properties
One of:
object
idstring<uuid>required
codestringrequired
namestringrequired
nameEnstring | nullrequired
Show properties
One of:
string
string
null
null
null
null
gameGamerequired
Show properties
idstring<uuid>
codestring
namestring
400

invalid_request: a parameter is invalid.

errorstringrequired

The error code

scopestring

With insufficient_scope, the missing scope

requestIdstring<uuid>
inventoryItemIdsstring<uuid>[]
holdIdsstring<uuid>[]
commitmentIdsstring<uuid>[]
401

invalid_token: the token is missing, expired, or for another resource.

errorstringrequired

The error code

scopestring

With insufficient_scope, the missing scope

requestIdstring<uuid>
inventoryItemIdsstring<uuid>[]
holdIdsstring<uuid>[]
commitmentIdsstring<uuid>[]
403

One of insufficient_scope, connection_revoked, client_disabled or forbidden.

errorstringrequired

The error code

scopestring

With insufficient_scope, the missing scope

requestIdstring<uuid>
inventoryItemIdsstring<uuid>[]
holdIdsstring<uuid>[]
commitmentIdsstring<uuid>[]
404

not_found

errorstringrequired

The error code

scopestring

With insufficient_scope, the missing scope

requestIdstring<uuid>
inventoryItemIdsstring<uuid>[]
holdIdsstring<uuid>[]
commitmentIdsstring<uuid>[]
409

Conflict, reused requestId or receipt not confirmed

errorstringrequired

The error code

scopestring

With insufficient_scope, the missing scope

requestIdstring<uuid>
inventoryItemIdsstring<uuid>[]
holdIdsstring<uuid>[]
commitmentIdsstring<uuid>[]
422

The state, target or value refuses the operation. Inspect error and affected IDs.

errorstringrequired

The error code

scopestring

With insufficient_scope, the missing scope

requestIdstring<uuid>
inventoryItemIdsstring<uuid>[]
holdIdsstring<uuid>[]
commitmentIdsstring<uuid>[]
Try it
Server
Authorization
Parameters
Bodyapplication/json
Request
curl -X POST 'https://api.toreca-cloud.com/partner/v1/inventory/items/497f6eca-6276-4993-bfeb-53cbbbba6f08/move' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "toLocationId": "e81ad314-9cb9-45ae-9ad9-f1b5ebcc7aae",
  "reason": "string"
}'
Response
{
  "moved": true,
  "item": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z",
    "assetNumber": "string",
    "sourceKind": "purchase",
    "status": "string",
    "version": 0,
    "siteId": "60189e9c-7d12-438c-b9ca-6998d9c364b1",
    "locationId": "1a5515a3-ba81-4a42-aee7-ad9ffc090a54",
    "grade": {
      "serviceCode": "string",
      "serviceName": "string",
      "serviceKind": "third_party",
      "code": "string",
      "label": "string",
      "numericScore": 0
    },
    "certificationNumber": "string",
    "certificationVerified": true,
    "conditionNote": "string",
    "acquisitionAmountMinor": 0,
    "currency": "string",
    "acquiredAt": "2019-08-24T14:15:22Z",
    "lastMovedAt": "2019-08-24T14:15:22Z",
    "allocation": "yours",
    "holdable": true,
    "commitment": {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "purpose": "oripa",
      "label": "string",
      "externalRef": "string"
    },
    "marketValue": {
      "amountMinor": 0,
      "currency": "JPY",
      "pricedAt": "2019-08-24T14:15:22Z"
    },
    "conditionTags": [
      {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "name": "string"
      }
    ],
    "photos": {
      "front": {
        "url": "http://example.com",
        "updatedAt": "2019-08-24T14:15:22Z"
      },
      "back": {
        "url": "http://example.com",
        "updatedAt": "2019-08-24T14:15:22Z"
      }
    },
    "card": {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "name": "string",
      "localizedNames": {
        "property1": "string",
        "property2": "string"
      },
      "cardNumber": "string",
      "languageCode": "string",
      "variant": "string",
      "finish": "string",
      "imageUrl": "string",
      "rarity": {
        "code": "string",
        "name": "string"
      },
      "set": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "code": "string",
        "name": "string",
        "nameEn": "string"
      },
      "game": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "code": "string",
        "name": "string"
      }
    }
  }
}

Was this page helpful?