• Conyac developer /
• Requester API v1 reference /
• Endpoints /
• Organizations

Organizations

Note: Organizations are known as Groups on the Conyac site.

• Creating a new organization
• Organization Details

Creating a new organization

Resource URL

POST /v1/organizations

Parameters

• name

  Organization name (required)

• description

  Description of your organization

Example Response

$ curl -i -H "Accept: application/json" -H "Content-type: application/json" -X POST https://biz.conyac.cc/api/v1/organizations -d '{"name": "hogehoge group", "description": "hogehogehoge"}'
HTTP/1.1 201 Created
Content-Type: application/json; charset=utf-8
Location: https://conyac.cc/api/v1/organizations/5

{
  "success": true,
  "message": "the organization is found.",
  "organization": {
    "id": 5,
    "name": "test group",
    "plan_id": 1,
    "user_id": 107,
    "default": 0,
    "description": "test decription",
    "created_at": "2014-06-10T10:32:48.830+09:00",
    "updated_at": "2014-06-10T10:32:48.830+09:00",
    "url": "https://biz.conyac.cc/api/v1/organizations/5",
    "html_url": "https://conyac.cc/b/organizations/5",
    "point": 0,
    "available_point": 0
  }
}

Organization Details

Resource URL

GET /v1/organizations/:id

Example Response

$ curl -i -H "Accept: application/json" -H "Content-type: application/json" -X GET https://biz.conyac.cc/api/v1/organizations/5?access_token=8c1525a501a5b10671b148003c65b1ed5c0598da5907f0a7855dc248faac8b76 
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

{
  "success": true,
  "message": "the organization is found.",
  "organization": {
    "id": 5,
    "name": "test group",
    "plan_id": 1,
    "user_id": 107,
    "default": 0,
    "description": "test decription",
    "created_at": "2014-06-10T10:32:48.000+09:00",
    "updated_at": "2014-06-10T10:32:48.000+09:00",
    "url": "https://biz.conyac.cc/api/v1/organizations/5",
    "html_url": "https://conyac.cc/b/organizations/5",
    "point": 0,
    "available_point": 0
  }
}