GET /v2/cursus/:cursus_id/teams
Return all the teams of the given Cursus
GET /v2/users/:user_id/teams
Return all the teams of the given User
GET /v2/users/:user_id/projects/:project_id/teams
Return all the teams of the given Project, associated with the given User
GET /v2/teams
Return all the teams
GET /v2/projects/:project_id/teams
Return all the teams of the given Project
GET /v2/project_sessions/:project_session_id/teams
Return all the teams of the given Project session
GET /v2/me/teams
Return all the teams for the current resource owner
live_help Notes
chrome_reader_mode
This resource is paginated by 30 items
settings Params
Param name | Description |
---|---|
cursus_id |
optional
. Must be String
The cursus id or slug |
user_id |
optional
. Must be String
The user id or slug |
project_id |
optional
. Must be String
The project id or slug |
project_session_id |
optional
. Must be String
The project_session id |
sort |
optional
. Must be one of: id , project_id , name , created_at , updated_at , locked_at , closed_at , final_mark , repo_url , repo_uuid , deadline_at , terminating_at , project_session_id , status .
The sort field. Sorted by id asc by default. MoreExample:To sort on teams on the fields project_session_id on a descending order and status on a ascending order: ...&sort=-project_session_id,status |
filter |
optional
. Must be one of: id , project_id , name , created_at , updated_at , locked_at , closed_at , final_mark , repo_url , repo_uuid , deadline_at , terminating_at , project_session_id , status , cursus , active_cursus , campus , primary_campus , locked , closed , deadline , terminating , with_mark .
Filtering on one or more fields MoreExample:
To filter on teams with the
...&filter[id]=a_value,another_value Filterable fields:
|
range |
optional
. Must be one of: id , project_id , name , created_at , updated_at , locked_at , closed_at , final_mark , repo_url , repo_uuid , deadline_at , terminating_at , project_session_id , status .
Select on a particular range MoreExample:
To range on teams with the
...&range[status]=min_value,max_value Rangeable fields:
|
page |
optional
. Must be a Hash
The pagination params, as a hash |
page[number] |
optional
. Must be Fixnum
The current page |
page[size] |
optional
. Must be Fixnum
The number of items per page, defaults to 30, maximum 100 |
Examples
GET /v2/teams
200
[
{
"id": 1,
"name": "jabinks2's group",
"url": "https://api.intra.42.fr/v2/teams/1",
"final_mark": null,
"project_id": 2,
"created_at": "2017-11-22T13:41:28.447Z",
"updated_at": "2017-11-22T13:41:28.519Z",
"status": "in_progress",
"terminating_at": null,
"users": [
{
"id": 111,
"login": "coundook",
"url": "https://api.intra.42.fr/v2/users/coundook",
"leader": true,
"occurrence": 0,
"validated": true,
"projects_user_id": 1
}
],
"locked?": true,
"validated?": null,
"closed?": false,
"repo_url": null,
"repo_uuid": "intra-uuid-e8f23ddc-8e52-47a8-87e9-9bd490621cfd-1",
"locked_at": "2017-11-22T13:41:28.487Z",
"closed_at": null,
"project_session_id": 2,
"scale_teams": [],
"teams_uploads": []
},
{
"id": 2,
"name": "podamer2's group",
"url": "https://api.intra.42.fr/v2/teams/2",
"final_mark": null,
"project_id": 4,
"created_at": "2017-11-22T13:41:28.554Z",
"updated_at": "2017-11-22T13:41:28.608Z",
"status": "in_progress",
"terminating_at": null,
"users": [
{
"id": 108,
"login": "podamer2",
"url": "https://api.intra.42.fr/v2/users/podamer2",
"leader": true,
"occurrence": 0,
"validated": true,
"projects_user_id": 2
}
],
"locked?": false,
"validated?": null,
"closed?": true,
"repo_url": null,
"repo_uuid": "intra-uuid-ae9bdbbc-9c16-4c27-8f18-eccee5a31020-2",
"locked_at": null,
"closed_at": "2017-11-22T13:41:28.578Z",
"project_session_id": 4,
"scale_teams": [],
"teams_uploads": []
},
{
"id": 3,
"name": "podamer2's group",
"url": "https://api.intra.42.fr/v2/teams/3",
"final_mark": null,
"project_id": 5,
"created_at": "2017-11-22T13:41:28.661Z",
"updated_at": "2017-11-22T13:41:28.704Z",
"status": "creating_group",
"terminating_at": null,
"users": [
{
"id": 108,
"login": "podamer2",
"url": "https://api.intra.42.fr/v2/users/podamer2",
"leader": true,
"occurrence": 0,
"validated": true,
"projects_user_id": 3
}
],
"locked?": false,
"validated?": null,
"closed?": false,
"repo_url": null,
"repo_uuid": "intra-uuid-d6aded82-d02e-4597-a33a-acd2544ec015-3",
"locked_at": null,
"closed_at": null,
"project_session_id": 5,
"scale_teams": [],
"teams_uploads": []
}
]
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" "https://api.intra.42.fr/v2/teams"
[
{
"id": 1,
"name": "jabinks2's group",
"url": "https://api.intra.42.fr/v2/teams/1",
"final_mark": null,
"project_id": 2,
"created_at": "2017-11-22T13:41:28.447Z",
"updated_at": "2017-11-22T13:41:28.519Z",
"status": "in_progress",
"terminating_at": null,
"users": [
{
"id": 111,
"login": "coundook",
"url": "https://api.intra.42.fr/v2/users/coundook",
"leader": true,
"occurrence": 0,
"validated": true,
"projects_user_id": 1
}
],
"locked?": true,
"validated?": null,
"closed?": false,
"repo_url": null,
"repo_uuid": "intra-uuid-e8f23ddc-8e52-47a8-87e9-9bd490621cfd-1",
"locked_at": "2017-11-22T13:41:28.487Z",
"closed_at": null,
"project_session_id": 2,
"scale_teams": [],
"teams_uploads": []
},
{
"id": 2,
"name": "podamer2's group",
"url": "https://api.intra.42.fr/v2/teams/2",
"final_mark": null,
"project_id": 4,
"created_at": "2017-11-22T13:41:28.554Z",
"updated_at": "2017-11-22T13:41:28.608Z",
"status": "in_progress",
"terminating_at": null,
"users": [
{
"id": 108,
"login": "podamer2",
"url": "https://api.intra.42.fr/v2/users/podamer2",
"leader": true,
"occurrence": 0,
"validated": true,
"projects_user_id": 2
}
],
"locked?": false,
"validated?": null,
"closed?": true,
"repo_url": null,
"repo_uuid": "intra-uuid-ae9bdbbc-9c16-4c27-8f18-eccee5a31020-2",
"locked_at": null,
"closed_at": "2017-11-22T13:41:28.578Z",
"project_session_id": 4,
"scale_teams": [],
"teams_uploads": []
},
{
"id": 3,
"name": "podamer2's group",
"url": "https://api.intra.42.fr/v2/teams/3",
"final_mark": null,
"project_id": 5,
"created_at": "2017-11-22T13:41:28.661Z",
"updated_at": "2017-11-22T13:41:28.704Z",
"status": "creating_group",
"terminating_at": null,
"users": [
{
"id": 108,
"login": "podamer2",
"url": "https://api.intra.42.fr/v2/users/podamer2",
"leader": true,
"occurrence": 0,
"validated": true,
"projects_user_id": 3
}
],
"locked?": false,
"validated?": null,
"closed?": false,
"repo_url": null,
"repo_uuid": "intra-uuid-d6aded82-d02e-4597-a33a-acd2544ec015-3",
"locked_at": null,
"closed_at": null,
"project_session_id": 5,
"scale_teams": [],
"teams_uploads": []
}
]
require "oauth2"
UID = "Your application uid"
SECRET = "Your application secret"
client = OAuth2::Client.new(UID, SECRET, site: "https://api.intra.42.fr")
token = client.client_credentials.get_token
response = token.get("/v2/teams")
response.status
# => 200
response.parsed
# => [{"id"=>1, "name"=>"jabinks2's group", "url"=>"https://api.intra.42.fr/v2/teams/1", "final_mark"=>nil, "project_id"=>2, "created_at"=>"2017-11-22T13:41:28.447Z", "updated_at"=>"2017-11-22T13:41:28.519Z", "status"=>"in_progress", "terminating_at"=>nil, "users"=>[{"id"=>111, "login"=>"coundook", "url"=>"https://api.intra.42.fr/v2/users/coundook", "leader"=>true, "occurrence"=>0, "validated"=>true, "projects_user_id"=>1}], "locked?"=>true, "validated?"=>nil, "closed?"=>false, "repo_url"=>nil, "repo_uuid"=>"intra-uuid-e8f23ddc-8e52-47a8-87e9-9bd490621cfd-1", "locked_at"=>"2017-11-22T13:41:28.487Z", "closed_at"=>nil, "project_session_id"=>2, "scale_teams"=>[], "teams_uploads"=>[]}, {"id"=>2, "name"=>"podamer2's group", "url"=>"https://api.intra.42.fr/v2/teams/2", "final_mark"=>nil, "project_id"=>4, "created_at"=>"2017-11-22T13:41:28.554Z", "updated_at"=>"2017-11-22T13:41:28.608Z", "status"=>"in_progress", "terminating_at"=>nil, "users"=>[{"id"=>108, "login"=>"podamer2", "url"=>"https://api.intra.42.fr/v2/users/podamer2", "leader"=>true, "occurrence"=>0, "validated"=>true, "projects_user_id"=>2}], "locked?"=>false, "validated?"=>nil, "closed?"=>true, "repo_url"=>nil, "repo_uuid"=>"intra-uuid-ae9bdbbc-9c16-4c27-8f18-eccee5a31020-2", "locked_at"=>nil, "closed_at"=>"2017-11-22T13:41:28.578Z", "project_session_id"=>4, "scale_teams"=>[], "teams_uploads"=>[]}, {"id"=>3, "name"=>"podamer2's group", "url"=>"https://api.intra.42.fr/v2/teams/3", "final_mark"=>nil, "project_id"=>5, "created_at"=>"2017-11-22T13:41:28.661Z", "updated_at"=>"2017-11-22T13:41:28.704Z", "status"=>"creating_group", "terminating_at"=>nil, "users"=>[{"id"=>108, "login"=>"podamer2", "url"=>"https://api.intra.42.fr/v2/users/podamer2", "leader"=>true, "occurrence"=>0, "validated"=>true, "projects_user_id"=>3}], "locked?"=>false, "validated?"=>nil, "closed?"=>false, "repo_url"=>nil, "repo_uuid"=>"intra-uuid-d6aded82-d02e-4597-a33a-acd2544ec015-3", "locked_at"=>nil, "closed_at"=>nil, "project_session_id"=>5, "scale_teams"=>[], "teams_uploads"=>[]}]